Класс геокодера
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 > Геокодирование запроса. |
Интерфейс запроса геокодера
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 . Будут возвращены только результаты, соответствующие всем фильтрам. Значения фильтра поддерживают те же методы исправления орфографии и частичного сопоставления, что и другие запросы геокодирования. Необязательный. |
extraComputations optional | Тип: Array < ExtraGeocodeComputation > optional Список дополнительных вычислений, которые можно использовать для выполнения запроса. Примечание. Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. |
fulfillOnZeroResults optional | Тип: boolean optional Выполните обещание при статусе ZERO_RESULT в ответе. Это может быть желательно, поскольку даже при нулевых результатах геокодирования все равно могут быть возвращены дополнительные поля уровня ответа. |
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 . Необязательный. |
Константы ExtraGeocodeComputation
google.maps . ExtraGeocodeComputation
Константы google.maps . ExtraGeocodeComputation
Дополнительные вычисления, которые необходимо выполнить при выполнении запроса на геокодирование.
Доступ осуществляется путем вызова const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
ADDRESS_DESCRIPTORS | Создайте дескриптор адреса. |
Константы геокодера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 s. |
address_descriptor optional | Тип: AddressDescriptor optional Реляционное описание местоположения. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение. Он заполняется только для запросов обратного геокодирования и только тогда, когда включен ExtraGeocodeComputation.ADDRESS_DESCRIPTORS . |
plus_code optional | Тип: PlacePlusCode optional Плюсовый код, связанный с местоположением. |
Интерфейс ГеокодераРезультат
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 Адресов и на Картах Google. Подробную информацию об идентификаторах мест можно найти в руководстве разработчика API Places. |
types | Тип: Array <string> Массив строк, обозначающий тип возвращаемого геокодированного элемента. Список возможных строк см. в разделе «Типы компонентов адреса» Руководства разработчика. |
address_descriptor optional | Тип: AddressDescriptor optional Реляционное описание местоположения, связанного с этим геокодом. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение. Оно будет заполняться только для запросов прямого геокодирования и поиска идентификаторов мест, только если включен ExtraGeocodeComputation.ADDRESS_DESCRIPTORS , и только для определенных локализованных мест. |
partial_match optional | Тип: boolean optional Не вернул ли геокодер точное совпадение с исходным запросом, хотя он смог сопоставить часть запрошенного адреса. Если точное совпадение, значение будет undefined . |
plus_code optional | Тип: PlacePlusCode optional Плюсовый код, связанный с местоположением. |
postcode_localities optional | Тип: Array <string> optional Массив строк, обозначающих все населенные пункты, содержащиеся в почтовом индексе. Это присутствует только в том случае, если результатом является почтовый индекс, содержащий несколько населенных пунктов. |
Интерфейс адресдескриптора
google.maps . AddressDescriptor
Интерфейс google.maps . AddressDescriptor
Реляционное описание местоположения. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение.
Характеристики | |
---|---|
areas | Ранжированный список содержащих или прилегающих территорий. Наиболее полезные (узнаваемые и точные) области располагаются на первом месте. |
landmarks | Ранжированный список близлежащих достопримечательностей. Самые полезные (узнаваемые и близлежащие) достопримечательности занимают первое место. |
Интерфейс 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 | Тип: GeocoderLocationType Тип местоположения, возвращаемый в 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 | Возвращенный результат отражает точный геокод. |
Интерфейс ориентира
google.maps . Landmark
Интерфейс google.maps . Landmark
Место, которое представляет собой точку отсчета для адреса.
Характеристики | |
---|---|
display_name | Тип: string Название достопримечательности. |
display_name_language_code | Тип: string Язык названия достопримечательности. |
place_id | Тип: string Идентификатор места базового заведения, служащего ориентиром. Может использоваться для получения дополнительной информации об ориентире с помощью сведений о месте или поиска по идентификатору места. |
spatial_relationship | Тип: SpatialRelationship Определяет пространственное соотношение между целевым местоположением и ориентиром. |
straight_line_distance_meters | Тип: number Расстояние по прямой между целевым местоположением и ориентиром. |
types | Тип: Array <string> Одно или несколько значений, указывающих тип возвращаемого результата. Более подробную информацию см. в разделе «Типы» . |
travel_distance_meters optional | Тип: number optional Расстояние перемещения по дорожной сети между целевым местоположением и ориентиром. Это значение может быть незаполнено, если ориентир не связан с той частью дорожной сети, к которой целевое местоположение находится ближе всего, ИЛИ если целевое местоположение фактически не считается находящимся в дорожной сети. |
Интерфейс области
google.maps . Area
Интерфейс google.maps . Area
Место, представляющее собой небольшой регион, например район, микрорайон или большой комплекс, содержащий целевое местоположение.
Характеристики | |
---|---|
containment | Тип: Containment Определяет пространственные отношения между целевым местоположением и областью. |
display_name | Тип: string Название местности. |
display_name_language_code | Тип: string Язык названия местности. |
place_id | Тип: string Идентификатор места базовой области. Может использоваться для получения дополнительной информации о районе с помощью сведений о месте или поиска по идентификатору места. |
Константы сдерживания
google.maps . Containment
Константы google.maps . Containment
Перечисление, представляющее пространственное отношение между областью и целевым местоположением.
Доступ осуществляется путем вызова const {Containment} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
NEAR | Целевое местоположение находится за пределами данного региона, но близко. |
OUTSKIRTS | Целевое местоположение находится внутри области области, близко к краю. |
WITHIN | Целевое местоположение находится в пределах области, недалеко от центра. |
Константы SpatialRelationship
google.maps . SpatialRelationship
Константы google.maps . SpatialRelationship
Перечисление, представляющее пространственную связь между ориентиром и целью.
Доступ осуществляется путем вызова const {SpatialRelationship} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
ACROSS_THE_ROAD | Цель находится прямо напротив ориентира на другой стороне дороги. |
AROUND_THE_CORNER | Не по тому же маршруту, что и достопримечательность, а в одном повороте. |
BEHIND | Близко к конструкции достопримечательности, но дальше от точки доступа. |
BESIDE | Цель находится непосредственно рядом с ориентиром. |
DOWN_THE_ROAD | На том же маршруте, что и ориентир, но не сбоку и не поперек. |
NEAR | Это отношение по умолчанию, когда не применимо ничего более конкретного, указанного ниже. |
WITHIN | Ориентир имеет пространственную геометрию и цель находится в его пределах. |
Класс геокодера
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 > Геокодирование запроса. |
Интерфейс запроса геокодера
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 . Будут возвращены только результаты, соответствующие всем фильтрам. Значения фильтра поддерживают те же методы исправления орфографии и частичного сопоставления, что и другие запросы геокодирования. Необязательный. |
extraComputations optional | Тип: Array < ExtraGeocodeComputation > optional Список дополнительных вычислений, которые можно использовать для выполнения запроса. Примечание. Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. |
fulfillOnZeroResults optional | Тип: boolean optional Выполните обещание при статусе ZERO_RESULT в ответе. Это может быть желательно, поскольку даже при нулевых результатах геокодирования все равно могут быть возвращены дополнительные поля уровня ответа. |
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 . Необязательный. |
Константы ExtraGeocodeComputation
google.maps . ExtraGeocodeComputation
Константы google.maps . ExtraGeocodeComputation
Дополнительные вычисления, которые необходимо выполнить при выполнении запроса на геокодирование.
Доступ осуществляется путем вызова const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
ADDRESS_DESCRIPTORS | Создайте дескриптор адреса. |
Константы геокодера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 s. |
address_descriptor optional | Тип: AddressDescriptor optional Реляционное описание местоположения. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение. Он заполняется только для запросов обратного геокодирования и только тогда, когда включен ExtraGeocodeComputation.ADDRESS_DESCRIPTORS . |
plus_code optional | Тип: PlacePlusCode optional Плюсовый код, связанный с местоположением. |
Интерфейс ГеокодераРезультат
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 Адресов и на Картах Google. Подробную информацию об идентификаторах мест можно найти в руководстве разработчика API Places. |
types | Тип: Array <string> Массив строк, обозначающий тип возвращаемого геокодированного элемента. Список возможных строк см. в разделе «Типы компонентов адреса» Руководства разработчика. |
address_descriptor optional | Тип: AddressDescriptor optional Реляционное описание местоположения, связанного с этим геокодом. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение. Оно будет заполняться только для запросов прямого геокодирования и поиска идентификаторов мест, только если включен ExtraGeocodeComputation.ADDRESS_DESCRIPTORS , и только для определенных локализованных мест. |
partial_match optional | Тип: boolean optional Не вернул ли геокодер точное совпадение с исходным запросом, хотя он смог сопоставить часть запрошенного адреса. Если точное совпадение, значение будет undefined . |
plus_code optional | Тип: PlacePlusCode optional Плюсовый код, связанный с местоположением. |
postcode_localities optional | Тип: Array <string> optional Массив строк, обозначающих все населенные пункты, содержащиеся в почтовом индексе. Это присутствует только в том случае, если результатом является почтовый индекс, содержащий несколько населенных пунктов. |
Интерфейс адресдескриптора
google.maps . AddressDescriptor
Интерфейс google.maps . AddressDescriptor
Реляционное описание местоположения. Включает ранжированный набор близлежащих ориентиров и областей, содержащих целевое местоположение.
Характеристики | |
---|---|
areas | Ранжированный список содержащих или прилегающих территорий. Наиболее полезные (узнаваемые и точные) области располагаются на первом месте. |
landmarks | Ранжированный список близлежащих достопримечательностей. Самые полезные (узнаваемые и близлежащие) достопримечательности занимают первое место. |
Интерфейс 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 | Тип: GeocoderLocationType Тип местоположения, возвращаемый в 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 | Возвращенный результат отражает точный геокод. |
Интерфейс ориентира
google.maps . Landmark
Интерфейс google.maps . Landmark
Место, которое представляет собой точку отсчета для адреса.
Характеристики | |
---|---|
display_name | Тип: string Название достопримечательности. |
display_name_language_code | Тип: string Язык названия достопримечательности. |
place_id | Тип: string Идентификатор места базового заведения, служащего ориентиром. Может использоваться для получения дополнительной информации об ориентире с помощью сведений о месте или поиска по идентификатору места. |
spatial_relationship | Тип: SpatialRelationship Определяет пространственное соотношение между целевым местоположением и ориентиром. |
straight_line_distance_meters | Тип: number Расстояние по прямой между целевым местоположением и ориентиром. |
types | Тип: Array <string> Одно или несколько значений, указывающих тип возвращаемого результата. Более подробную информацию см. в разделе «Типы» . |
travel_distance_meters optional | Тип: number optional Расстояние перемещения по дорожной сети между целевым местоположением и ориентиром. Это значение может быть незаполнено, если ориентир не связан с той частью дорожной сети, к которой целевое местоположение находится ближе всего, ИЛИ если целевое местоположение фактически не считается находящимся в дорожной сети. |
Интерфейс области
google.maps . Area
Интерфейс google.maps . Area
Место, представляющее собой небольшой регион, например район, микрорайон или большой комплекс, содержащий целевое местоположение.
Характеристики | |
---|---|
containment | Тип: Containment Определяет пространственные отношения между целевым местоположением и областью. |
display_name | Тип: string Название местности. |
display_name_language_code | Тип: string Язык названия местности. |
place_id | Тип: string Идентификатор места базовой области. Может использоваться для получения дополнительной информации о районе с помощью сведений о месте или поиска по идентификатору места. |
Константы сдерживания
google.maps . Containment
Константы google.maps . Containment
Перечисление, представляющее пространственное отношение между областью и целевым местоположением.
Доступ осуществляется путем вызова const {Containment} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
NEAR | Целевое местоположение находится за пределами данного региона, но близко. |
OUTSKIRTS | Целевое местоположение находится в пределах области, близко к краю. |
WITHIN | Целевое местоположение находится в пределах области, недалеко от центра. |
Константы SpatialRelationship
google.maps . SpatialRelationship
Константы google.maps . SpatialRelationship
Перечисление, представляющее пространственную связь между ориентиром и целью.
Доступ осуществляется путем вызова const {SpatialRelationship} = await google.maps.importLibrary("geocoding")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
ACROSS_THE_ROAD | Цель находится прямо напротив ориентира на другой стороне дороги. |
AROUND_THE_CORNER | Не по тому же маршруту, что и достопримечательность, а в одном повороте. |
BEHIND | Близко к конструкции достопримечательности, но дальше от точки доступа. |
BESIDE | Цель находится непосредственно рядом с ориентиром. |
DOWN_THE_ROAD | На том же маршруте, что и ориентир, но не сбоку и не поперек. |
NEAR | Это отношение по умолчанию, когда не применимо ничего более конкретного, указанного ниже. |
WITHIN | Ориентир имеет пространственную геометрию и цель находится в его пределах. |