A API Geocoding é um serviço que oferece geocodificação e geocodificação inversa de endereços.
A geocodificação é o processo de conversão de endereços (como um endereço de rua) em coordenadas geográficas (como latitude e longitude), que você pode usar para colocar marcadores em um mapa ou posicioná-lo.
A geocodificação inversa é o processo de conversão de coordenadas geográficas em um endereço legível.
Você também pode usar a API Geocoding para encontrar o endereço de um determinado ID de lugar.
Exemplo de solicitação e resposta
Você acessa a API Geocoding por uma interface HTTP. Confira 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 testar isso, insira o URL no navegador da Web. Substitua
YOUR_API_KEY pela sua chave de API real.
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 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 em 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_KEYPara testar isso, insira o URL no navegador da Web. Não se esqueça de substituir "YOUR_API_KEY" pela sua chave de API real. A resposta inclui um endereço legível por humanos para a latitude e a longitude.
Consulte o guia do desenvolvedor para mais informações sobre como criar URLs de solicitação de geocodificação reversa e parâmetros disponíveis e 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 do serviço da Web do Google Maps, oferecendo implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e repetição automática. A API Geocoding está disponível nos clientes Java, Python, Go e Node.js para serviços do Google Maps.
Autenticação, cotas, preços e políticas
Autenticação
Para usar a API Geocoding, primeiro é preciso ativá-la e receber as credenciais de autenticação adequadas. Para mais informações, consulte Começar a usar a Plataforma Google Maps.
Cotas e preços
Consulte a página Uso e faturamento para conferir 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 mais com a API Geocoding. Consulte o guia para desenvolvedores da API Geocoding para conferir mais demonstrações, exemplos, parâmetros disponíveis, códigos de status e mensagens de erro e outros detalhes.
O guia para desenvolvedores 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.