Visão geral da API Geocoding

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

Por que usar a API Geocoding

Use a API Geocoding em um site ou aplicativo 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 do mapa em um endereço. Esse serviço foi desenvolvido para geocodificar endereços estáticos predefinidos para inserir conteúdo do app em um mapa.

O que você pode fazer com a API Geocoding

Você pode usar a API Geocoding para receber dados de geocodificação de um ou mais endereços ou locais, incluindo os seguintes:

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

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

Como a API Geocoding funciona

A Geocoding API 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. É possível usar essas coordenadas para inserir 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 usá-los em diversas situações, incluindo entregas ou retiradas.

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

Recursos

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

Recursos de dados Dados retornados Formato de devolução
Geocoding Retorna endereços, componentes de endereços e tipos de endereços. Consulte Resultados no guia de Solicitação e resposta de geocodificação.
  • JSON
  • XML
Geocodificação inversa Retorna endereços, componentes de endereços e tipos de endereços. Consulte Respostas de geocodificação inversa no guia Solicitação e resposta de geocodificação inversa.
Geocodificação de locais Retorna endereços, componentes de endereços e tipos de endereços. 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 em Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Tentar uma solicitação de geocodificação Quando você tiver uma chave de API, poderá começar a testar a API Geocoding diretamente no cURL ou em um navegador. Você precisa fornecer os parâmetros de pesquisa corretos para pesquisas de endereço ou componente. Consulte Parâmetros de geocodificação para mais detalhes.
3 Tentar uma solicitação de geocodificação inversa Forneça coordenadas de latitude/longitude junto com sua chave de API para receber componentes de endereço do endereço legível mais próximo desse local. Consulte Solicitações de geocodificação inversa para mais detalhes.
4 Noções básicas sobre respostas Todos os endpoints da API Geocoding retornam os mesmos dados em JSON ou XML. Consulte Respostas de geocodificação para ver 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 de sua escolha usando 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 com código aberto sob a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir