Поля

Методы

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

jQuery

function jQuery

Фреймворк jQuery.

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

location

Object location

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

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

• 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 - не использовать.

Возвращает:

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 дн."

Параметры:

Возвращает:

load

load(callback)

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

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

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

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

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

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

См.: Загрузка API

Параметры:

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