YMaps

Поля

Имя Описание
jQuery

Фреймворк jQuery.

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

location

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

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

Методы

Имя Возвращает Описание
humanDistance (distance, roughly) String

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

humanDuration (duration) String

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

load (callback)

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

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

jQuery

function jQuery

Фреймворк jQuery.

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

location

Object location

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

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

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

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

Пример:

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

Integer TILE_SIZE

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

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

humanDistance

{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 - округляется с точностью до одного километра (км).

Пример:

// Округление расстояний с различной точностью. 
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 false true - использовать грубое округление, false - не использовать.

Возвращает:

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

humanDuration

{String} humanDuration(duration)

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

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

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

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

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

Пример:

// Округление времени с различной точностью.
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(callback)

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

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

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

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

Вызывать YMaps.load можно несколько раз, при этом обработчики накапливаются в стеке. По окончании загрузки обработчики вызываются в порядке попадания в стек.

Если YMaps.load вызван после загрузки API или API подключен без параметра loadByRequire, то обработчик выполняется сразу же.

См.: Загрузка по требованию

Параметры:

Имя Тип Необязательный По умолчанию Описание
callback Function Обработчик окончания загрузки API.