Os descritores de endereço incluem informações adicionais que ajudam a descrever um local usando pontos de referência e áreas. Confira a demonstração de descritores de endereço para conhecer o recurso.
Parâmetros adicionais
Os descritores de endereço podem ser ativados usando o parâmetro extra_computations. Inclua extra_computations=ADDRESS_DESCRIPTORS em uma solicitação de geocodificação, solicitação de geocodificação inversa ou solicitação de geocodificação de lugares para receber descritores de endereço na sua resposta.
Exemplo de geocodificação
A consulta a seguir contém o endereço de um lugar em Délhi:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Exemplo de geocodificação de lugares
A consulta a seguir contém o ID de um lugar em Deli:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Exemplo de geocodificação inversa
A consulta a seguir contém o valor de latitude/longitude de um local em Deli:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Resposta
Confira um exemplo de 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" ]
}
]
}
}
Há duas matrizes em cada objeto address_descriptor: landmarks e areas. A matriz landmarks contém até cinco resultados classificados por ordem de relevância, considerando a proximidade da coordenada solicitada, a prevalência do ponto de referência e a visibilidade dele. Cada resultado de ponto de referência contém os seguintes valores:
place_idé o ID do lugar do resultado de pontos de referência. Consulte a visão geral do ID de lugar.display_nameé o nome de exibição do ponto de referência e contémlanguage_codeetext.straight_line_distance_metersé a distância ponto a ponto em metros entre a coordenada de entrada e o resultado de pontos de referência.travel_distance_metersé a distância em metros percorrida pela rede viária (ignorando restrições de via) entre a coordenada de entrada e o resultado de pontos de referência.spatial_relationshipé a relação estimada entre a coordenada de entrada e o resultado dos pontos de referência:"NEAR"é a relação padrão quando nenhuma das opções a seguir se aplica."WITHIN"quando a coordenada de entrada está dentro dos limites da estrutura associada ao ponto de referência."BESIDE"quando a coordenada de entrada está diretamente adjacente ao ponto de referência ou ao ponto de acesso dele."ACROSS_THE_ROAD"quando a coordenada de entrada está diretamente oposta ao ponto de referência do outro lado do trajeto."DOWN_THE_ROAD"quando a coordenada de entrada está na mesma rota que o ponto de referência, mas não é"BESIDES"nem"ACROSS_THE_ROAD"."AROUND_THE_CORNER"quando a coordenada de entrada está em uma rota perpendicular ao ponto de referência (restrita a uma única curva)."BEHIND"quando a coordenada de entrada está espacialmente próxima ao ponto de referência, mas longe do ponto de acesso.typessão os tipos de lugar do ponto de referência.
O objeto areas contém até três respostas e se limita a lugares que representam pequenas regiões, como bairros, sublocalidades e grandes complexos. As áreas que contêm a coordenada solicitada são listadas primeiro e ordenadas da menor para a maior. Cada resultado de areas contém os seguintes valores:
place_idé o ID de lugar do resultado de áreas. Consulte a visão geral do ID de lugar.display_nameé o nome de exibição da área e contémlanguage_codeetext.containmenté a relação de contenção estimada entre a coordenada de entrada e o resultado das áreas:"NEAR"é a relação padrão quando nenhuma das opções a seguir se aplica."WITHIN"quando a coordenada de entrada está próxima ao centro da área."OUTSKIRTS"quando a coordenada de entrada está perto da borda da área.
Cobertura
Os descritores de endereço estão disponíveis em todas as regiões. Consulte os detalhes em Cobertura regional.
Feedback
Esse recurso está disponível em todas as regiões e em GA na Índia. Em todas as outras regiões, ele está na fase de lançamento experimental pré-GA. Agradecemos seu feedback. Registre um bug no Issue Tracker.