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:
Esta versão da API Geocoding v4 inclui o lançamento dos seguintes endpoints:
- Geocodificar um endereço: coordenadas geográficas de endereços. Também chamada de geocodificação direta.
- Geocodificar um local: endereços para conjuntos de coordenadas de latitude e longitude. Também chamada de geocodificação inversa.
- Geocodificação de lugar: recupera um endereço de um ID de lugar.
- Pesquisar destinos: pesquise um destino usando um endereço, ID de lugar ou local.
É possível controlar onde os resultados aparecem e restringi-los a uma região, um país ou um código postal específico.
Teste a demonstração
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 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 e 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 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 a documentação de resposta de geocodificação. |
|
| Geocodificação inversa | Retorna o endereço, os componentes e os tipos de endereço. Consulte a documentação sobre a resposta de geocodificação inversa. | |
| Geocodificação de lugares | Retorna o endereço, os componentes e os tipos de endereço. Consulte a documentação de resposta de geocodificação de lugar. | |
| Pesquisa de destino | Retorna informações detalhadas sobre vários destinos com base em diferentes critérios de entrada, como um endereço, ID de lugar ou coordenadas de latitude e longitude. Consulte a documentação sobre pesquisa de destino. |
Canais de fase de lançamento
A versão 4 da API Geocoding tem canais separados para recursos em GA, pré-lançamento e
experimentais. Se você quiser usar recursos de pré-lançamento ou experimentais, especifique o canal correto na solicitação. Por exemplo,
para acessar recursos do endpoint Destinations em Experimental, use esta solicitação
HTTP: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| Etapa do lançamento | Nome do canal |
|---|---|
| GA | /v4/ |
| Visualizar | /v4beta/ |
| Experimental | /v4alpha/ |
- Consulte a referência da REST para ver uma lista e uma descrição de todos os recursos REST disponíveis.
- Consulte as fases de lançamento para mais informações sobre cada fase.
Recursos da API Geocoding v4
A versão 4 da API Geocoding oferece estes novos recursos.
Método de pesquisa de destino
A v4 apresenta um método de pesquisa de destino que permite recuperar informações detalhadas sobre vários destinos com base em diferentes critérios de entrada, como endereço, ID de lugar ou coordenadas de latitude e longitude. A resposta inclui resumos com tecnologia de IA e tokens de ponto de navegação que contêm informações contextuais que podem ser transmitidas ao SDK de navegação para rotas precisas.
Implementado na plataforma padrão do Google Cloud
A API Geocoding v4 é implementada na infraestrutura de serviço no Google Cloud. Essa implementação traz uma plataforma mais segura e confiável, com opções de segurança aprimoradas, como o OAuth. Esse design de API padrão traz um nível de consistência entre as APIs que melhora a eficiência do desenvolvimento com a API Geocoding v4.
Suporte ao OAuth adicionado
A API Geocoding v4 é compatível com o uso do OAuth 2.0 para autenticação. O Google oferece suporte a cenários comuns do OAuth 2.0, como os de um servidor da Web.
Adição de suporte à máscara de campo
Use máscaras de campo para especificar quais informações a resposta deve retornar. Para os métodos Geocodificar um endereço, Geocodificar um local e Geocodificar um lugar, todos os campos no objeto de resposta são retornados por padrão. Para o método Pesquisar destinos, é necessário especificar uma máscara de campo na solicitação de API.
Segurança de APIs
A API Geocoding v4 foi projetada como uma API de servidor para servidor. As chamadas diretas do lado do cliente de um navegador expõem as chaves de API a um risco significativo de roubo e uso indevido, já que as restrições de referenciador HTTP não são proteção suficiente para endpoints de serviço da Web.
Recomendamos que você chame a API Geocoding v4 do seu próprio servidor de back-end. Para mais detalhes sobre padrões de implementação seguros e alternativas para necessidades do lado do cliente, consulte Considerações de segurança.