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:
Esta versão da API Geocoding v4 inclui o lançamento dos seguintes endpoints:
- (Prévia) Geocodificar um endereço — Coordenadas geográficas para endereços. Também chamado de geocodificação direta.
- (Prévia) Fazer geocodificação de um local — Endereços para conjuntos de coordenadas de latitude e longitude. Também chamada de geocodificação inversa.
- (Pré-lançamento) Geocodificação de lugar — Recupere um endereço de um ID de lugar.
- (Pré-lançamento) Pesquisar destinos — Pesquise um destino usando um endereço, ID do lugar ou local.
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 e longitude ou um ID de lugar em um endereço legível. 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 endpoint 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 de geocodificação. |
|
| Geocodificação inversa | Retorna endereço, componentes de endereço e tipos de endereço. Consulte a documentação sobre a resposta da geocodificação inversa. | |
| Geocoding de lugares | Retorna endereço, componentes de endereço e tipos de endereço. Consulte a documentação sobre a 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, um 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 esses novos recursos.
Endpoint de pesquisa de destino
A v4 apresenta um endpoint 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 pontos 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ços 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 padrão de API traz um nível de consistência entre as APIs que melhora a eficiência do desenvolvimento com a API Geocoding v4.
Suporte para OAuth adicionado
A API Geocoding v4 é compatível com o uso do OAuth 2.0 para autenticação. O Google aceita cenários comuns do OAuth 2.0, como os de um servidor da Web.
Suporte para máscara de campo adicionado
Use máscaras de campo para especificar quais informações a resposta deve retornar. Para os endpoints 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 endpoint Pesquisar destinos, especifique uma máscara de campo na solicitação da API.
Sem custo financeiro durante o pré-lançamento
A API Geocoding v4 está na fase de pré-lançamento antes da disponibilidade geral, e não há cobranças pelo uso da API durante o pré-lançamento. As chamadas de API vão aparecer na página "Faturamento" do console do Cloud, mas as cobranças serão de US $0.
Feedback
Este é um recurso em pré-lançamento. Agradecemos seu feedback em geocoding-feedback-channel@google.com.