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.
A API Geocoding v4 oferece inteligência hiperlocal de destino e chegada e resolução de coordenadas para endereços. Seja para criar uma experiência de entrega de última milha, transporte por aplicativo ou navegação guiada, ou para normalizar endereços em coordenadas, a v4 oferece endpoints dedicados adaptados ao seu caso de uso.
Não sabe qual endpoint é adequado para seu aplicativo? Consulte Escolher um método de geocodificação.
O que você pode fazer com a API Geocoding
A API Geocoding v4 inclui os seguintes recursos e endpoints:
- Pesquisar destinos: recupere detalhes de chegada hiperlocais para um destino com base em um endereço, ID de lugar ou coordenadas, incluindo entradas de edifícios, tokens de ponto de navegação roteáveis, contornos de edifícios e terrenos, subdestinos e pontos de referência próximos.
- Geocodificar um endereço: converta endereços em coordenadas geográficas e IDs de lugar (geocodificação direta).
- Geocodificar um local: converta coordenadas de latitude e longitude em endereços ou áreas político-administrativas legíveis por humanos (geocodificação inversa).
- Geocodificar um lugar: recuperar detalhes de endereço formatados e coordenadas de um ID de lugar conhecido do Google Maps.
É 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 v4 é compatível com a pesquisa de destinos e a geocodificação básica:
- Pesquisa de destino (
SearchDestinations): resolve um endereço, ID de lugar ou par de coordenadas em um objetoDestinationdetalhado. Use esse método quando a chegada física for importante, como identificar as entradas preferenciais de um edifício, direcionar motoristas para pontos de retirada ou entrega designados usando tokens de ponto de navegação, renderizar contornos de edifícios em um mapa ou navegar em complexos com vários edifícios. - Geocodificação básica: converte endereços, coordenadas e IDs de lugar:
- Geocodificação: converte endereços, como "1600 Amphitheatre Parkway, Mountain View, CA", em coordenadas de latitude e longitude ou IDs de lugar para colocar marcadores ou centralizar o frame de visualização do mapa.
- Geocodificação inversa: converte coordenadas de latitude e longitude ou IDs de lugar em endereços legíveis por humanos para pins de mapa inseridos pelo usuário, seletores de local ou exibição de interface.
- Geocodificação de lugar: recupera detalhes de endereço e coordenadas de um ID de lugar conhecido do Google Maps.
A tabela a seguir resume os recursos disponíveis na API Geocoding v4, além dos dados que cada método retorna:
| Recursos de dados | Dados retornados | Formato de retorno |
|---|---|---|
| Pesquisar destinos ( POST /v4/geocode/destinations)
|
Retorna inteligência de chegada hiperlocal: polígonos de edifícios e terrenos (displayPolygon), entrances físico, navigationPoints roteável (com tokens), containingPlaces e subDestinations hierárquicos, landmarks relacional e Place Details primários. Consulte Pesquisar destinos.
|
|
| Geocodificar um endereço ( GET /v4/geocode/address)
|
Retorna o endereço, os componentes e os tipos de endereço. Consulte Resposta de geocodificação. | |
| Geocodificar um local ( GET /v4/geocode/location)
|
Retorna o endereço, os componentes e os tipos de endereço. Consulte Resposta de geocodificação inversa. | |
| Geocodificar um lugar ( GET /v4/geocode/places)
|
Retorna o endereço, os componentes e os tipos de endereço. Consulte Resposta de geocodificação de lugar. |
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.