geolocation

Статический объект.

Предоставляет информацию о местоположении пользователя.

Методы

Методы

Имя Возвращает Описание
get([options])

vow.Promise

Пытается определить местоположение пользователя. Возвращает объект-promise, который будет либо подтверждён объектом с полем geoObjects, либо отклонён с сообщением об ошибке. Поле geoObjects является экземпляром GeoObjectCollection. В коллекцию будет добавлен объект, обозначающий текущее местоположение пользователя.

Описание методов

get

Пытается определить местоположение пользователя. Возвращает объект-promise, который будет либо подтверждён объектом с полем geoObjects, либо отклонён с сообщением об ошибке. Поле geoObjects является экземпляром GeoObjectCollection. В коллекцию будет добавлен объект, обозначающий текущее местоположение пользователя.

Возвращает объект-promise.

Параметры:

Параметр Значение по умолчанию Описание
options

Тип:

options.autoReverseGeocode true

Тип:

true - автоматически прогеокодировать положение пользователя, false - вернуть как есть. В случае автоматического геокодирования объект, обозначающий текущее местоположение пользователя, будет иметь структуру, аналогичную результату выполнения geocode.

options.mapStateAutoApply false

Тип:

true - при добавлении на карту автоматически выставить центр и уровень масштабрования карты так, чтобы показать текущее местоположение пользователя, false - ничего не делать.

options.provider 'auto'

Тип:

Провайдер геолокации. Допустимые значения: 'yandex' - геолокация по данным Яндекса на основе ip пользователя, 'browser' - встроенная браузерная геолокация, 'auto' - провести геолокацию всеми доступными способами и выбрать лучшее значение.

options.timeout 30000

Тип:

Время ожидания ответа в мс.

options.useMapMargin true

Тип: Boolean

Нужно ли учитывать отступы карты map.margin.Manager при автоматическом выставлении центра и уровня масштаба карте.

Примеры:

1.

ymaps.geolocation.get({
        // Выставляем опцию для определения положения по ip    provider: 'yandex',    
        // Карта автоматически отцентрируется по положению пользователя.
        mapStateAutoApply: true
    })
    .then(function (result) {
        myMap.geoObjects.add(result.geoObjects);
    });

2.

ymaps.geolocation.get({
        // Зададим способ определения геолокации    
        // на основе ip пользователя.
        provider: 'yandex',
        // Включим автоматическое геокодирование результата.
        autoReverseGeocode: true
    })
    .then(function (result) {
        // Выведем результат геокодирования.
        console.log(result.geoObjects.get(0)
            .properties.get('metaDataProperty'));
    });