Visão geral da API Geocoding

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 vice-versa.

Por que usar a API Geocoding

Use a API Geocoding para sites ou aplicativos para dispositivos móveis quando quiser usar dados de geocodificação em mapas fornecidos por uma das APIs da Plataforma Google Maps. Com a API Geocoding, você usa endereços para colocar marcadores em um mapa ou converter um marcador em um mapa em um endereço. Este serviço foi projetado para geocodificar endereços estáticos predefinidos para inserir o conteúdo do aplicativo em um mapa.

O que você pode fazer com a API Geocoding

Você pode usar a API Geocoding para ver 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 local.

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

Como a API Geocoding funciona

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

  • Geocodificação: converte endereços como "1600 Amphitheatre Parkway, Mountain View, CA" em coordenadas de latitude e longitude ou IDs de lugares. Você pode usar essas coordenadas para posicionar 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. É possível usar endereços para diversas situações, incluindo entregas ou retiradas.

A demonstração a seguir usa o serviço Geocoding com a API Maps JavaScript para demonstrar como a API Geocoding funciona. Abra o mapa em outra guia para conferir mais opções e detalhes.

Recursos

A tabela a seguir resume os recursos disponíveis por meio da API Geocoding com os dados que cada endpoint retorna.

Recursos de dados Dados retornados Formato de devolução
Geocoding Retorna endereço, componentes de endereço e tipos de endereço. Consulte Resultados no guia Solicitação e resposta da geocodificação.
  • JSON
  • XML
Geocodificação inversa Retorna endereço, componentes de endereço e tipos de endereço. Consulte Respostas de geocodificação inversa no guia Solicitação e resposta de geocodificação inversa.
Geocodificação do lugar Retorna endereço, componentes de endereço e tipos de endereço. Consulte Respostas de geocodificação inversa no guia Solicitação e resposta de geocodificação do lugar.

Como usar a API Geocoding

1 Prepare-se. Comece com Configurar seu projeto do Google Cloud e siga 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 ver detalhes.
3 Tentar usar uma solicitação de geocodificação inversa Forneça coordenadas de latitude/longitude junto com sua chave de API para receber os componentes do endereço legível mais próximo do local. Consulte Solicitações de geocodificação inversa para mais detalhes.
4 Noções básicas sobre respostas Todos os pontos de extremidade da API Geocoding retornam os mesmos dados em JSON ou XML. Consulte Respostas da geocodificação para uma explicação sobre os dados, os códigos de status e as mensagens de erro.
5 Incorpore dados de geocodificação no seu app. Você pode usar dados de geocodificação para extrair 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 que quiser usando uma destas 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 delas no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir