Esta página mostra solicitações e respostas para recuperar um endereço de um ID de lugar.
Parâmetros obrigatórios
place_id
: o ID do lugar para o qual você quer receber o endereço legível. O ID do lugar é um identificador exclusivo que pode ser usado com outras APIs do Google. Por exemplo, você pode usar oplaceID
retornado pela API Roads para conferir o endereço de um ponto alinhado. Para mais informações sobre os IDs de lugar, consulte a visão geral do ID de lugar.key
: a chave de API do seu app. Essa chave identifica seu aplicativo para fins de gerenciamento de cota. Saiba como receber uma chave.
Os parâmetros opcionais são os mesmos da geocodificação reversa.
A consulta a seguir contém um ID de local para uma localização no Brooklyn:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJd8BlQ2BZwokRAFUEcm_qrcA
&key=YOUR_API_KEY
A consulta acima retorna o seguinte resultado:
{
"results" : [
{
"address_components" : [
{
"long_name" : "277",
"short_name" : "277",
"types" : [ "street_number" ]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" : [ "route" ]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" : [ "neighborhood", "political" ]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" : [ "political", "sublocality", "sublocality_level_1" ]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" : {
"location" : {
"lat" : 40.7142205,
"lng" : -73.9612903
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 40.71556948029149,
"lng" : -73.95994131970849
},
"southwest" : {
"lat" : 40.7128715197085,
"lng" : -73.9626392802915
}
}
},
"place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
"types" : [ "street_address" ]
}
],
"status" : "OK"
}
Para uma descrição dos campos na resposta, consulte Respostas de geocodificação.