Visão geral da API Geocoding

Desenvolvedores do Espaço Econômico Europeu (EEE)

A API Geocoding é um serviço que aceita um lugar como endereço, coordenadas de latitude e longitude ou ID de lugar. Ela converte o endereço em coordenadas de latitude e longitude e um ID de lugar, ou converte coordenadas de latitude e longitude ou um ID de lugar em um endereço.

O que você pode fazer com a API Geocoding

Use a API Geocoding para receber dados de geocodificação de um ou mais endereços ou lugares, incluindo:

  • Coordenadas geográficas para endereços.
  • Endereços para conjuntos de coordenadas de latitude e longitude.
  • Endereços para IDs de lugar.

É possível controlar onde os resultados aparecem e restringi-los a uma região, município ou código postal específico.

Como a API Geocoding funciona

A API Geocoding faz geocodificação e geocodificação inversa:

  • Geocodificação: converte endereços como "1600 Amphitheatre Parkway, Mountain View, CA" em coordenadas de latitude e longitude ou IDs de lugar. Você pode usar essas coordenadas para colocar marcadores em um mapa ou para centralizar ou reposicionar o mapa no frame de visualização.
  • Geocodificação inversa: converte coordenadas de latitude/longitude ou um ID de lugar em um endereço legível por humanos. Você pode usar endereços em vários cenários, incluindo entregas ou retiradas.

A demonstração a seguir usa o serviço Geocoding pela API Maps JavaScript para mostrar como a API Geocoding funciona. Abra o mapa em uma guia separada para ver mais opções e detalhes.

Recursos

A tabela a seguir resume os recursos disponíveis na API Geocoding e os dados que cada método retorna.

Recursos de dados Dados retornados Formato de retorno
Geocoding Retorna o endereço, os componentes e os tipos de endereço. Consulte Resultados no guia Solicitação e resposta de geocodificação.
  • JSON
  • XML
Geocodificação inversa Retorna o endereço, os componentes e os tipos de endereço. Consulte Respostas de geocodificação inversa no guia de solicitação e resposta de geocodificação inversa.
Geocodificação de lugares Retorna o endereço, os componentes e os tipos de endereço. Consulte Respostas de geocodificação inversa no guia de solicitação e resposta de geocodificação de lugares.

Como usar a API Geocoding

1 Configure o recurso. Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir.
2 Testar uma solicitação de geocodificação Depois de ter uma chave de API, você pode começar a testar a API Geocoding diretamente do curl ou de um navegador. Você precisará fornecer os parâmetros de pesquisa corretos para pesquisas de endereço ou componente. Consulte Parâmetros de geocodificação para mais detalhes.
3 Testar uma solicitação de geocodificação inversa Forneça as coordenadas de latitude/longitude com sua chave de API para receber os componentes do endereço legível por humanos mais próximo desse local. Consulte Solicitações de geocodificação inversa para mais detalhes.
4 Noções básicas sobre respostas Todos os métodos na API Geocoding retornam os mesmos dados em JSON ou XML. Consulte Respostas de geocodificação para uma explicação dos dados, códigos de status e mensagens de erro.
5 Incorpore dados de geocodificação ao seu app. Você pode usar dados de geocodificação para receber endereços de marcadores de mapa ou fornecer marcadores em um mapa com base em um endereço conhecido.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem de sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0. Faça o download deles no GitHub, onde você também encontra instruções de instalação e exemplos de código.

A seguir