A API Geocoding é um serviço que aceita um lugar como um 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
Você pode usar a API Geocoding para receber dados de geocodificação de um ou mais endereços ou lugares, incluindo o seguinte:
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 de 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 : pesquisa um destino de um endereço, ID de lugar ou local.
Você pode controlar onde os resultados aparecem e restringi-los a uma região, município ou código postal específico.
Teste a demonstração
Como a API Geocoding funciona
A API Geocoding faz geocodificação e geocodificação inversa:
- Geocodificação: converte endereços como "Av. Paulista, 1600, São Paulo, SP" 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. Você pode usar endereços para 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 endereço, componentes de endereço e tipos de endereço. Consulte a documentação de resposta da Geocoding. |
|
| Geocodificação inversa | Retorna endereço, componentes de endereço e tipos de endereço. Consulte a documentação de resposta da geocodificação inversa. | |
| Geocodificação de lugar | Retorna endereço, componentes de endereço e tipos de endereço. Consulte a documentação de resposta da 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 da pesquisa de destino. |
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 um 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 Navigation para um trajeto preciso.
Implementado na plataforma padrão do Google Cloud
A API Geocoding v4 é implementada na infraestrutura de serviço do Google Cloud. Essa implementação traz uma plataforma mais segura e confiável com opções de segurança aprimoradas, como OAuth. Esse design de API padrão oferece 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 oferece suporte ao 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.
Suporte à máscara de campo adicionado
Use máscaras de campo para especificar quais informações a resposta precisa retornar. Para os métodos Geocodificar um endereço, Geocodificar um local e Geocodificação de 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ços 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.