Primeiros passos

A Geocoding API é um serviço que fornece geocodificação e geocodificação reversa 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 posicione o mapa.

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 uma ID de lugar fornecido.

Exemplo de solicitação e resposta

A API Geocoding é acessada por uma interface HTTP. Seguindo são exemplos de solicitações de geocodificação e de 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 em seu navegador da Web (não se esqueça de substituir YOUR_API_KEY pela 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 criação de URLs de solicitação de geocodificação e parâmetros disponíveis e para 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, Nova York, 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, insira o URL em seu 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 para a latitude e a longitude o local.

Consulte o Guia para desenvolvedores para mais informações sobre criar URLs de solicitação de geocodificação inversa e parâmetros disponíveis e para 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 desenvolver com as APIs de serviços da web do Google Maps fornecendo recursos implementações nativas de tarefas comuns, como autenticação, solicitação limitação e nova tentativa automática. 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 você precisa ativá-la e consiga as credenciais de autenticação adequadas. Para mais informações, consulte Comece a usar a Plataforma Google Maps.

Cotas e preços

Revise o uso e o faturamento para ver 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 a Políticas de API.

Saiba mais

Você pode fazer muito mais com a API Geocoding. Consulte a guia do desenvolvedor da API Geocoding para ver 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 a serviço da Web da API Geocoding. É destinado a desenvolvedores de sites e dispositivos móveis que querem usar dados de geocodificação em mapas fornecidos por uma das ferramentas da Plataforma Google Maps APIs de terceiros.