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]) Параметры: request : GeocoderRequest callback : function( Array < GeocoderResult > optional , GeocoderStatus ): void optional Возвращаемое значение: 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	Тип: GeocoderComponentRestrictions 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 Places и на Google Maps. Узнайте больше об идентификаторах мест в руководстве для разработчиков Places API. Геокодер выполняет обратное геокодирование. Дополнительную информацию см. в разделе Обратное геокодирование . Должен быть указан один и только один address , location и placeId .
region optional	Тип: string optional Код страны, используемый для смещения поиска, указанный как двухсимвольный (нечисловой) вложенный тег региона Unicode / идентификатор 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 . Необязательный.

Константы GeocoderStatus

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, возвращенный Geocoder , содержащий список GeocoderResult s.

Характеристики
results	Тип: Array < GeocoderResult > Список GeocoderResult s.

Интерфейс GeocoderResult

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

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

Характеристики
address_components	Тип: Array < GeocoderAddressComponent > Массив GeocoderAddressComponent s
formatted_address	Тип: string Строка, содержащая удобочитаемый адрес этого местоположения.
geometry	Тип: GeocoderGeometry Объект GeocoderGeometry
place_id	Тип: string Идентификатор места, связанный с местоположением. Идентификаторы мест однозначно идентифицируют место в базе данных Google Places и на Google Maps. Узнайте больше об идентификаторах мест в руководстве для разработчиков Places API.
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> Массив строк, обозначающих тип этого компонента адреса. Список допустимых типов можно найти здесь

Интерфейс GeocoderGeometry

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

Геометрическая информация об этом GeocoderResult

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

Константы GeocoderLocationType

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	Возвращаемый результат отражает точный геокод.