---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps


## Поля

#|
|| **Имя** | **Описание** ||
||[jQuery](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md#jQuery) | Фреймворк [jQuery](http://jquery.com/).

Используется версия 1.3.2.||
||[location](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md#location) | Предположительное местоположение пользователя, вычисленное на основе его IP адреса. Отсутствует, если определить местоположение пользователя не удалось.||
||[TILE_SIZE](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md#TILE_SIZE) | Размер тайла (в пикселах).||
|#

# Методы


Имя | Возвращает | Описание
----- | ----- | -----
[humanDistance](ymaps.md#humanDistance) (distance, roughly) | String | Приводит расстояние в метрах к удобочитаемому строковому представлению.
[humanDuration](ymaps.md#humanDuration) (duration) | String | Приводит время в секундах к удобочитаемому строковому представлению.
[load](ymaps.md#load) (callback) |  | Инициирует загрузку функционала API Яндекс.Карт. Используется совместно с параметром loadByRequire.

## Подробное описание полей

### jQuery {#jQuery}

```javascript
function jQuery
```

Фреймворк [jQuery](http://jquery.com/).

Используется версия 1.3.2.
### location {#location}

```javascript
Object location
```

Предположительное местоположение пользователя, вычисленное на основе его IP адреса. Отсутствует, если определить местоположение пользователя не удалось.


{% note info %}

При использовании браузера Internet Explorer возможно некорректное отображение русских символов в случае, если кодировка страницы с картой отличается от UTF-8. Для решения проблемы следует либо изменить кодировку страницы на UTF-8, либо указать используемую кодировку при загрузке API.

{% endnote %}


Имеет следующие поля:

- longitude - долгота;
- latitude - широта;
- city - название города;
- region - название региона;
- country - название страны.

**Пример:**

```javascript
var map = new YMaps.Map(YMaps.jQuery("#ymap")[0]), center;
if (YMaps.location) {
    center = new YMaps.GeoPoint(YMaps.location.longitude, YMaps.location.latitude);
    map.openBalloon(center, "Место вашего предположительного местоположения:<br/>"
        + (YMaps.location.country || "")
        + (YMaps.location.region ? ", " + YMaps.location.region : "")
        + (YMaps.location.city ?  ", " + YMaps.location.city : "")
    )
} else {
    center = new YMaps.GeoPoint(37.61, 55.75);
}
map.setCenter(center, 10);
```
### TILE_SIZE {#TILE_SIZE}

```javascript
Integer TILE_SIZE
```

Размер тайла (в пикселах).

## Подробное описание методов

### humanDistance {#humanDistance}

```javascript
{String} humanDistance(distance, roughly)
```

Приводит расстояние в метрах к удобочитаемому строковому представлению.

Обычное округление (в скобках указаны единицы вывода расстояния):

- distance < 0.02 - округляется с точностью до миллиметра (мм);
- 0.02 <= distance < 0.2 - округляется с точностью до сантиметра (см);
- 0.2 <= distance < 2 - округляется с точностью до одной сотой метра (м);
- 2 <= distance < 20 - округляется с точностью до одной десятой метра (м);
- 20 <= distance < 1000 - округляется с точностью до одного метра (м);
- 1000 <= distance < 2000 - округляется с точностью до одного метра (км);
- 2000 <= distance < 7000 - округляется с точностью до 10 метров (км);
- 7000 <= distance < 50000 - округляется с точностью до 100 метров (км);
- 50000 <= distance - округляется с точностью до одного километра (км).

Грубое округление (roughly равно true):

- distance < 10 - округляется с точностью до одного метра (м);
- 10 <= distance < 100 - округляется с точностью до 10 метров (м);
- 100 <= distance < 1000 - округляется с точностью до 50 метров (м);
- 1000 <= distance < 3000 - округляется с точностью до 100 метров (км);
- 3000 <= distance - округляется с точностью до одного километра (км).

**Пример:**

```javascript
// Округление расстояний с различной точностью. 
YMaps.humanDistance(158.5) // "159 м"
YMaps.humanDistance(1158.5) // "1,159 км"
YMaps.humanDistance(2158.5) // "2,16 км"
YMaps.humanDistance(7158.5) // "7,2 км"
YMaps.humanDistance(50158.5) // "50 км"
YMaps.humanDistance(158.5, true) // "150 м"
YMaps.humanDistance(1158.5, true) // "1,2 км"
YMaps.humanDistance(2158.5, true) // "2,2 км"
YMaps.humanDistance(7158.5, true) // "7 км"
YMaps.humanDistance(50158.5, true) // "50 км"
```

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`distance` | Number |  |  | Расстояние в метрах.
`roughly` | Boolean | ![](../_images/check.png) | false | true - использовать грубое округление, false - не использовать.


**Возвращает:**

Тип | Описание
----- | -----
String | Строковое представление расстояния.

### humanDuration {#humanDuration}

```javascript
{String} humanDuration(duration)
```

Приводит время в секундах к удобочитаемому строковому представлению.

Если время меньше 20 минут, то округляется с точностью до секунд.

Если время меньше 20 часов, то округляется с точностью до минут.

Если время меньше 20 суток, то округляется с точностью до часов.

Если время более 20 суток, то округляется с точностью до суток.

**Пример:**

```javascript
// Округление времени с различной точностью.
YMaps.humanDuration(0.4) // "0 сек."
YMaps.humanDuration(1199) // "19 мин. 59 сек."
YMaps.humanDuration(1200) // "20 мин."
YMaps.humanDuration(71969) // "19 час. 59 мин."
YMaps.humanDuration(71970) // "20 час."
YMaps.humanDuration(1726199) // "19 дн. 23 час."
YMaps.humanDuration(1726200) // "20 дн."
```

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`duration` | Number | Время в секундах.


**Возвращает:**

Тип | Описание
----- | -----
String | Строковое представление времени.

### load {#load}

```javascript
load(callback)
```

Инициирует загрузку функционала API Яндекс.Карт. Используется совместно с параметром loadByRequire.

Позволяет загружать API Яндекс.Карт по требованию, например, при возникновении какого-либо DOM-события или при вызове определенной пользовательской функции.

Если API подключено с параметром loadByRequire = 1, то API загружается при вызове этого метода. При обычном подключении API загрузка происходит одновременно с загрузкой страницы.

В качестве параметра метод может принимать обработчик, который будет вызван по окончании загрузки.

Вызывать [YMaps.load](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md#load) можно несколько раз, при этом обработчики накапливаются в стеке. По окончании загрузки обработчики вызываются в порядке попадания в стек.

Если [YMaps.load](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ymaps.md#load) вызван после загрузки API или API подключен без параметра loadByRequire, то обработчик выполняется сразу же.

**См.:** [Загрузка API](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/tasks/api-loading.md)

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`callback` | Function | ![](../_images/check.png) |  | Обработчик окончания загрузки API.