A API Geocoding é um serviço de geocodificação e geocodificação inversa de endereços.
Geocodificação é o processo de converter endereços (como um endereço) em coordenadas geográficas (como latitude e longitude), que você pode usar para colocar marcadores em um mapa ou posicionar o mapa.
A geocodificação inversa é o processo de conversão de coordenadas geográficas em um endereço legível.
Também é possível usar a API Geocoding para encontrar o endereço de um determinado ID de local.
Exemplo de solicitação e resposta
Acesse a API Geocoding por uma interface HTTP. Veja a seguir exemplos de solicitações de geocodificação e geocodificação inversa.
Solicitação e resposta de geocodificação (pesquisa de latitude/longitude)
O exemplo a seguir solicita a latitude e a longitude de "1600 Amphitheatre Parkway, Mountain View, CA" e especifica que a saída precisa estar no formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Para fazer um teste, digite o URL no navegador da Web. Lembre-se de substituir YOUR_API_KEY pela chave de API.
A resposta inclui a latitude e a longitude do endereço.
Consulte o Guia para desenvolvedores para mais informações sobre como criar URLs de solicitação de geocodificação e parâmetros disponíveis e sobre como entender a resposta.
Veja a seguir um exemplo de resposta de geocodificação em JSON:
{
"results" : [
{
"address_components" : [
{
"long_name" : "1600",
"short_name" : "1600",
"types" : [ "street_number" ]
},
{
"long_name" : "Amphitheatre Parkway",
"short_name" : "Amphitheatre Pkwy",
"types" : [ "route" ]
},
{
"long_name" : "Mountain View",
"short_name" : "Mountain View",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Clara County",
"short_name" : "Santa Clara County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "California",
"short_name" : "CA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
},
{
"long_name" : "94043",
"short_name" : "94043",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
"geometry" : {
"location" : {
"lat" : 37.4267861,
"lng" : -122.0806032
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 37.4281350802915,
"lng" : -122.0792542197085
},
"southwest" : {
"lat" : 37.4254371197085,
"lng" : -122.0819521802915
}
}
},
"place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
"plus_code" : {
"compound_code" : "CWC8+R3 Mountain View, California, United States",
"global_code" : "849VCWC8+R3"
},
"types" : [ "street_address" ]
}
],
"status" : "OK"
}
Solicitação e resposta de geocodificação reversa (pesquisa de endereço)
O exemplo a seguir solicita o endereço correspondente a uma determinada latitude/longitude no Brooklyn, NY, EUA. Ele especifica que a saída deve ser no formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY
Para testar isso, digite o URL no navegador da Web. Lembre-se de substituir "YOUR_API_KEY" pela sua chave de API real. A resposta inclui um endereço legível para a localização de latitude e longitude.
Consulte o Guia para desenvolvedores para mais informações sobre como criar URLs de solicitação de geocodificação inversa e parâmetros disponíveis e como entender a resposta.
Veja a seguir um exemplo de resposta de geocodificação reversa em JSON:
{
"plus_code" : {
"compound_code" : "P27Q+MC New York, NY, USA",
"global_code" : "87G8P27Q+MC"
},
"results" : [
{
"address_components" : [
{
"long_name" : "279",
"short_name" : "279",
"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" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" : {
"location" : {
"lat" : 40.7142484,
"lng" : -73.9614103
},
"location_type" : "ROOFTOP",
"viewport" : {
"northeast" : {
"lat" : 40.71559738029149,
"lng" : -73.9600613197085
},
"southwest" : {
"lat" : 40.71289941970849,
"lng" : -73.96275928029151
}
}
},
"place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
"plus_code" : {
"compound_code" : "P27Q+MC Brooklyn, New York, United States",
"global_code" : "87G8P27Q+MC"
},
"types" : [
"bakery",
"cafe",
"establishment",
"food",
"point_of_interest",
"store"
]
},
... Additional results truncated in this example[] ...
],
"status" : "OK"
}
Começar a codificar com nossas bibliotecas cliente
As bibliotecas de cliente facilitam o desenvolvimento com as APIs Web Service do Google Maps porque fornecem implementações nativas e simples de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A API Geocoding está disponível no cliente Java, cliente Python, cliente Go e cliente Node.js para serviços do Google Maps.
Autenticação, cotas, preços e políticas
Autenticação
Para usar a API Geocoding, primeiro ative a API e consiga as credenciais de autenticação adequadas. Para mais informações, consulte o artigo Começar a usar a Plataforma Google Maps.
Cotas e preços
Consulte a página de uso e faturamento para mais detalhes sobre as cotas e os preços definidos para a API Geocoding.
Políticas
O uso da API Geocoding precisa estar de acordo com as políticas da API.
Saiba mais
Você pode fazer muito mais com a API Geocoding. Consulte o guia do desenvolvedor da API Geocoding para mais demonstrações, exemplos, parâmetros disponíveis, códigos de status e mensagens de erro, além de outros detalhes.
O guia do desenvolvedor da API Geocoding descreve o serviço da Web da API Geocoding. Ele é destinado a desenvolvedores de sites e dispositivos móveis que querem usar dados de geocodificação em mapas fornecidos por uma das APIs da Plataforma Google Maps.