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 um endereço, coordenadas de latitude e longitude ou ID de lugar. Ele converte o endereço em coordenadas de latitude e longitude e um ID do lugar ou converte coordenadas de latitude e longitude ou um ID do 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.

Você pode controlar onde os resultados aparecem e restringi-los a uma região, condado ou CEP 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. É possível 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 mostrar como a API Geocoding funciona. Abra o mapa em uma guia separada para conferir mais opções e detalhes.

Recursos

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

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

Como usar a API Geocoding

1 Configure agora. Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração.
2 Fazer 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ê 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 Tente uma solicitação de geocodificação inversa Forneça coordenadas de latitude/longitude com sua chave de API para receber componentes de endereço do endereço legível mais próximo para esse local. Consulte Solicitações de geocodificação inversa para mais detalhes.
4 Entender os conceitos básicos de respostas Todos os endpoints da API Geocoding retornam os mesmos dados em JSON ou XML. Consulte Respostas da API Geocoding para uma explicação dos dados, códigos de status e mensagens de erro.
5 Incorpore dados de geocodificação no seu próprio app! É possível 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 no idioma 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 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