Geocoder

Класс геокодера

google.maps . Geocoder Класс google.maps . Geocoder

Сервис для преобразования адреса в LatLng .

Доступ осуществляется путем вызова const {Geocoder} = await google.maps.importLibrary("geocoding") . См. раздел Библиотеки в Maps JavaScript API .

Geocoder
Geocoder()
Параметры: Нет
Создает новый экземпляр Geocoder , который отправляет запросы геокодирования на серверы Google.
geocode
geocode(request[, callback])
Параметры:
Возвращаемое значение: Promise < GeocoderResponse >
Геокодирование запроса.

Интерфейс GeocoderRequest

google.maps . GeocoderRequest Интерфейс google.maps . GeocoderRequest

Спецификация запроса на геокодирование, отправляемого в Geocoder .

address optional
Тип: string optional
Адрес для геокодирования. Должен быть указан один и только один address , location и placeId .
bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
LatLngBounds в пределах которого осуществляется поиск. Необязательный.
componentRestrictions optional
Компоненты используются для ограничения результатов определенной областью. Фильтр состоит из одного или нескольких элементов: route , locality , administrativeArea , postalCode , country . Будут возвращены только результаты, соответствующие всем фильтрам. Значения фильтра поддерживают те же методы исправления орфографии и частичного сопоставления, что и другие запросы геокодирования. Необязательный.
language optional
Тип: string optional
Идентификатор языка, на котором должны возвращаться результаты, если это возможно. См. список поддерживаемых языков .
location optional
Тип: LatLng | LatLngLiteral optional
LatLng (или LatLngLiteral ) для поиска. Геокодер выполняет обратное геокодирование. Дополнительную информацию см. в разделе Обратное геокодирование . Должен быть указан один и только один address , location и placeId .
placeId optional
Тип: string optional
Идентификатор места, связанный с местоположением. Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. Подробную информацию об идентификаторах мест можно найти в руководстве для разработчиков Places API. Геокодер выполняет обратное геокодирование. Дополнительную информацию см. в разделе Обратное геокодирование . Должен быть указан один и только один address , location и placeId .
region optional
Тип: string optional
Код страны, используемый для смещения поиска в виде двухсимвольного (нечислового) субтега региона Юникода/идентификатора CLDR. Необязательный. См. сведения о покрытии платформы Google Maps для поддерживаемых регионов.

Интерфейс GeocoderComponentRestrictions

google.maps . GeocoderComponentRestrictions Интерфейс google.maps . GeocoderComponentRestrictions

GeocoderComponentRestrictions представляет собой набор фильтров, которые разрешаются для определенной области. Подробную информацию о том, как это работает, см. в разделе Фильтрация компонентов геокодирования .

administrativeArea optional
Тип: string optional
Соответствует всем administrative_area levels . Необязательный.
country optional
Тип: string optional
Соответствует названию страны или двухбуквенному коду страны по стандарту ISO 3166-1. Необязательный.
locality optional
Тип: string optional
Соответствует как типам locality , так и sublocality . Необязательный.
postalCode optional
Тип: string optional
Соответствует postal_code и postal_code_prefix . Необязательный.
route optional
Тип: string optional
Соответствует длинному или короткому имени route . Необязательный.

Константы геокодераStatus

google.maps . GeocoderStatus Константы google.maps . GeocoderStatus

Статус, возвращаемый Geocoder после завершения вызова geocode() . Укажите их по значению или используя имя константы. Например, 'OK' или google.maps.GeocoderStatus.OK .

Доступ осуществляется путем вызова const {GeocoderStatus} = await google.maps.importLibrary("geocoding") . См. раздел Библиотеки в Maps JavaScript API .

ERROR Возникла проблема с подключением к серверам Google.
INVALID_REQUEST Этот GeocoderRequest недействителен.
OK Ответ содержит действительный GeocoderResponse .
OVER_QUERY_LIMIT Веб-страница превысила лимит запросов за слишком короткий период времени.
REQUEST_DENIED Веб-странице не разрешено использовать геокодер.
UNKNOWN_ERROR Запрос на геокодирование не удалось обработать из-за ошибки сервера. Запрос может быть успешным, если вы повторите попытку.
ZERO_RESULTS Для этого GeocoderRequest результат не найден.

Интерфейс GeocoderResponse

google.maps . GeocoderResponse Интерфейс google.maps . GeocoderResponse

Ответ геокодера, возвращаемый Geocoder , содержащий список GeocoderResult .

results
Тип: Array < GeocoderResult >
Список GeocoderResult .

Интерфейс ГеокодераРезультат

google.maps . GeocoderResult Интерфейс google.maps . GeocoderResult

Одиночный результат геокодирования, полученный с сервера геокодирования. Запрос геокодирования может возвращать несколько объектов результата. Обратите внимание: хотя этот результат и «подобен JSON», он не является строго JSON, поскольку косвенно включает объект LatLng .

address_components
Массив GeocoderAddressComponent s
formatted_address
Тип: string
Строка, содержащая удобочитаемый адрес этого местоположения.
geometry
Объект GeocoderGeometry
place_id
Тип: string
Идентификатор места, связанный с местоположением. Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. Подробную информацию об идентификаторах мест можно найти в руководстве разработчика API Places.
types
Тип: Array <string>
Массив строк, обозначающий тип возвращаемого геокодированного элемента. Список возможных строк см. в разделе «Типы компонентов адреса» Руководства разработчика.
partial_match optional
Тип: boolean optional
Не вернул ли геокодер точное совпадение с исходным запросом, хотя он смог сопоставить часть запрошенного адреса. Если точное совпадение, значение будет undefined .
plus_code optional
Тип: PlacePlusCode optional
Плюсовый код, связанный с местоположением.
postcode_localities optional
Тип: Array <string> optional
Массив строк, обозначающих все населенные пункты, содержащиеся в почтовом индексе. Это присутствует только в том случае, если результатом является почтовый индекс, содержащий несколько населенных пунктов.

Интерфейс GeocoderAddressComponent

google.maps . GeocoderAddressComponent Интерфейс google.maps . GeocoderAddressComponent

Один компонент адреса в GeocoderResult . Полный адрес может состоять из нескольких компонентов адреса.

long_name
Тип: string
Полный текст компонента адреса
short_name
Тип: string
Сокращенный краткий текст данного компонента адреса.
types
Тип: Array <string>
Массив строк, обозначающих тип этого компонента адреса. Список допустимых типов можно найти здесь.

Интерфейс ГеокодерГеометрия

google.maps . GeocoderGeometry Интерфейс google.maps . GeocoderGeometry

Информация о геометрии этого GeocoderResult

location
Тип: LatLng
Координаты широты и долготы этого результата
location_type
Тип местоположения, возвращаемый в location
viewport
Тип: LatLngBounds
Границы рекомендуемого окна просмотра для отображения этого GeocoderResult
bounds optional
Тип: LatLngBounds optional
Точные границы этого GeocoderResult , если применимо.

Константы геокодерлокациитипе

google.maps . GeocoderLocationType Константы google.maps . GeocoderLocationType

Описывает тип местоположения, возвращаемого из геокода. Укажите их по значению или используя имя константы. Например, 'ROOFTOP' или google.maps.GeocoderLocationType.ROOFTOP .

Доступ осуществляется путем вызова const {GeocoderLocationType} = await google.maps.importLibrary("geocoding") . См. раздел Библиотеки в Maps JavaScript API .

APPROXIMATE Возвращаемый результат является приблизительным.
GEOMETRIC_CENTER Возвращаемый результат — это геометрический центр результата, например линия (например, улица) или многоугольник (регион).
RANGE_INTERPOLATED Возвращаемый результат отражает аппроксимацию (обычно на дороге), интерполированную между двумя точными точками (например, перекрестками). Интерполированные результаты обычно возвращаются, когда геокоды крыш недоступны для адреса.
ROOFTOP Возвращенный результат отражает точный геокод.