Дескрипторы адресов возвращают дополнительную информацию в стандартный ответ обратного геокодирования , который помогает описать координаты широты и долготы с помощью ориентиров и областей. Ознакомьтесь с демонстрацией дескрипторов адресов , чтобы изучить API.
Запросы обратного геокодирования – Дополнительные параметры
Дополнительные параметры
Это необязательные параметры, которые вы можете включить в запрос обратного геокодирования:
-
enable_address_descriptor— логический параметр, который необходимо включить в запрос обратного геокодирования , чтобы добавить дескриптор адреса в стандартный ответ обратного геокодирования .
Пример обратного геокодирования
Следующий запрос содержит значение широты и долготы для местоположения в Дели:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
Ответ
Приведенный выше запрос возвращает дополнительный address_descriptor следующим образом:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
В каждом объекте address_descriptor есть два массива: landmarks и areas . Массив landmarks содержит до 5 результатов, ранжированных в порядке релевантности с учетом близости к запрашиваемой координате, распространенности ориентира и его видимости. Каждый результат ориентира содержит следующие значения:
-
place_id— это идентификатор места в результате поиска ориентиров. См. обзор идентификаторов мест . -
display_name— отображаемое имя ориентира, содержащееlanguage_codeиtext. -
straight_line_distance_meters— это расстояние от точки до точки в метрах между входной координатой и результатом ориентиров. -
travel_distance_meters— это расстояние в метрах, пройденное по дорожной сети (без учета дорожных ограничений) между входной координатой и результатом ориентиров. -
spatial_relationship— это предполагаемая взаимосвязь между входной координатой и результатом определения ориентиров: -
"NEAR"— это отношение по умолчанию, когда не применяется ни одно из следующих условий. -
"WITHIN"когда входная координата находится в пределах структуры, связанной с ориентиром. -
"BESIDE"когда входная координата находится непосредственно рядом с ориентиром или точкой доступа к ориентиру. -
"ACROSS_THE_ROAD"когда входная координата находится прямо напротив ориентира на другой стороне маршрута. -
"DOWN_THE_ROAD"если входная координата находится на том же маршруте, что и ориентир, но не"BESIDES"или"ACROSS_THE_ROAD". -
"AROUND_THE_CORNER"когда входная координата находится вдоль перпендикулярного маршрута в качестве ориентира (ограничено одним поворотом). -
"BEHIND"когда входная координата пространственно близка к ориентиру, но далеко от точки доступа. -
types— это типы мест ориентира.
Объект areas содержит до трех ответов и ограничивается местами, которые представляют небольшие регионы, такие как кварталы, микрорайоны и крупные комплексы. Области, содержащие запрошенную координату, перечислены первыми и упорядочены от меньшего к большему. Результат каждой areas содержит следующие значения:
-
place_id— это идентификатор места результата областей. См. обзор идентификаторов мест . -
display_name— это отображаемое имя области, содержащееlanguage_codeиtext. -
containment— это предполагаемое соотношение сдерживания между входной координатой и результатом областей: -
"NEAR"— это отношение по умолчанию, когда не применяется ни одно из следующих условий. -
"WITHIN"когда входная координата близка к центру области. -
"OUTSKIRTS"когда входная координата близка к краю области.
Покрытие
Эта функция доступна только в некоторых странах .
Обратная связь
Это экспериментальная функция, и мы будем признательны за отзывы. Напишите нам по адресу адрес-дескрипторы-feedback@google.com .