Geocoder

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

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

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

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 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

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

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
Массив GeocoderAddressComponent s
formatted_address
Тип: string
Строка, содержащая удобочитаемый адрес этого местоположения.
geometry
Объект 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
Тип местоположения, возвращаемый в location
viewport
Тип: LatLngBounds
Границы рекомендуемого окна просмотра для отображения этого GeocoderResult
bounds optional
Тип: LatLngBounds optional
Точные границы этого GeocoderResult , если применимо

Константы GeocoderLocationType

google.maps . GeocoderLocationType

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

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