Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps Geocoding API

Para começar, orientaremos você pelo Google Developers Console para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps Geocoding API
  3. Criar chaves apropriadas
Continuar

Primeiros passos

A Google Maps Geocoding API é um serviço que oferece geocodificação e geocodificação reversa de endereços.

Este serviço também está disponível como parte da Google Maps JavaScript API do lado do cliente ou para uso do lado do servidor com Java Client, Python Client, Go Client e Node.js Client for Google Maps Services.

A geocodificação é o processo de converter endereços (como nome da rua e número) em coordenadas geográficas (latitude e longitude) que permitem a inserção de marcadores de local em um mapa ou o posicionamento do mapa.

A geocodificação inversa é o processo de conversão de coordenadas geográficas em um endereço legível. O serviço de geocodificação inversa da Google Maps Geocoding API também permite que você encontre o endereço de um determinado ID de local.

Exemplo de solicitação e resposta

A Google Maps Geocoding API é acessada por uma interface HTTP. Veja a seguir exemplos de solicitação de geocodificação e geocodificação reversa.

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 deve ser no formato JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

Esse exemplo pode ser testado inserindo o URL no navegador da Web (não deixe de substituir 'YOUR_API_KEY' pela chave de API real). A resposta inclui a latitude e a longitude do endereço.

Consulte o guia do desenvolvedor para obter mais informações sobre a criação de URLs de solicitação de geocodificação e os parâmetros disponíveis, bem como sobre como interpretar 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 Pkwy",
               "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 Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "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_KEY

Esse exemplo pode ser testado inserindo o URL no navegador da Web (não deixe de substituir 'YOUR_API_KEY' pela chave de API real). A resposta inclui um endereço legível correspondente ao local da latitude/longitude.

Consulte o guia do desenvolvedor para obter mais informações sobre a criação de URLs de solicitação de geocodificação reversa e os parâmetros disponíveis, bem como sobre como interpretar a resposta.

Veja a seguir um exemplo de resposta de geocodificação reversa em JSON:

{
   "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" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "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 Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

Começar a codificar com nossas bibliotecas cliente

As bibliotecas cliente facilitam o desenvolvimento com as Web Service APIs do Google Maps, oferecendo implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A Google Maps Geocoding API está disponível nos clientes Java Client, Python Client, Go Client e Node.js Client for Google Maps Services.

Autenticação, cotas e políticas

Ativar a API e obter uma chave de API

Para usar a Google Maps Geocoding API, você deve antes ativar a API no Google API Console e obter as credenciais de autenticação adequadas. Você precisa informar uma chave de API em cada solicitação (ou um ID do cliente se tiver um Plano premium).

Clique no botão a seguir para continuar em um processo onde você poderá:

  1. Criar ou selecionar um projeto
  2. Ativar a API
  3. Obter uma chave de API
Obter uma chave

Saiba mais sobre a autenticação de credenciais.

Cotas

Consulte a página de limites de uso para obter detalhes sobre as cotas definidas para a Google Maps Geocoding API.

Políticas

O uso da Google Maps Geocoding API deve estar de acordo com as políticas de APIs.

Saiba mais

Você pode fazer mais coisas com a Geocoding API. Consulte o guia do desenvolvedor da Geocoding API para obter demonstrações, exemplos, parâmetros disponíveis, códigos de status e mensagens de erro adicionais, além de outros detalhes.

Enviar comentários sobre…

Google Maps Geocoding API
Google Maps Geocoding API
Precisa de ajuda? Acesse nossa página de suporte.