Visão geral da API Geocoding

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

Por que usar a Geocoding API

Use a Geocoding API para site ou app para dispositivos móveis quando quiser usar os dados de geocodificação nos 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 para um endereço. Este serviço foi projetado para geocodificar endereços estáticos predefinidos para posicionar o conteúdo do aplicativo em um mapa.

O que você pode fazer com a Geocoding API

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

Você pode controlar onde os resultados aparecem e restringi-los a uma região, condado ou CEP específico.

Como a Geocoding API 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. 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. Você pode usar endereços para vários cenários, incluindo entregas ou retiradas.

A demonstração a seguir usa o serviço Geocoding pela API Maps JavaScript para demonstrar 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 por meio da Geocoding API e os dados retornados por cada endpoint.

Recursos de dados Dados retornados Formato de retorno
Geocoding Retorna endereços, componentes de endereço e tipos de endereço. Consulte Resultados no guia Solicitação e resposta de geocodificação.
  • JSON
  • XML
Geocodificação inversa Retorna endereços, 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 de lugares Retorna endereços, componentes de endereço e tipos de endereço. Consulte Respostas de geocodificação inversa no guia Solicitação e resposta de geocodificação de lugar.

Como usar a Geocoding API

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 Quando tiver uma chave de API, você poderá começar a testar a API Geocoding diretamente do cURL ou de um navegador. Será necessário fornecer os parâmetros de pesquisa corretos para pesquisas de endereço ou componente. Consulte Parâmetros de geocodificação para detalhes.
3 Testar uma solicitação de geocodificação reversa Forneça coordenadas de latitude/longitude juntamente com sua chave de API para receber componentes de endereço para o endereço legível mais próximo para esse local. Consulte Solicitações de geocodificação inversa para detalhes.
4 Noções básicas sobre respostas Todos os pontos de extremidade da Geocoding API retornam os mesmos dados em JSON ou XML. Consulte Respostas de geocodificação para uma explicação sobre os 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 obter 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 no idioma 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 com suporte da comunidade e código aberto sob a Licença Apache 2.0 (em inglês). Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e códigos de amostra.

A seguir