Há uma versão mais recente deste documento com exemplos de como usar as novas APIs Places e Routes.
Normalmente, quando o usuário está dirigindo até um ponto de interesse (PDI), ele precisa de navegação até um local próximo, como um estacionamento ou um ponto de acesso. Imagine um motorista que precisa ir a um aeroporto ou shopping center. Ao ir para um aeroporto, o motorista tenta chegar a um terminal ou a um ponto de desembarque, e não ao centro do complexo aeroportuário. Da mesma forma, um estacionamento ao lado do shopping center pode ser uma opção muito melhor para um usuário com um carro. Nesse caso, ao desenvolver um app ou serviço para orientar o motorista, primeiro encontre o local de destino e depois ofereça destinos opcionais próximos a esse local. Essa abordagem permite oferecer um serviço melhor aos clientes e demonstrar que você valoriza o tempo deles, com um esforço de desenvolvimento pequeno, mas inteligente, que aproveita os dados de localização fornecidos pela Plataforma Google Maps.
Visão simplificada dos sistemas envolvidos ao guiar o motorista até um local de carro

Vamos mostrar como usar as APIs Places e Directions em sequência ou combinação para identificar o local certo para estacionar perto do seu destino. Essa solução visa remover a incerteza e várias interações para encontrar um lugar para estacionar enquanto dirige perto do destino final. Vamos analisar dois exemplos de como esses casos podem ser implementados em detalhes.
Exemplo 1: uma atração turística sem estacionamento
Vamos escolher um local que não esteja diretamente conectado à beira da estrada para que uma rota precise ser recuperada separadamente. O destino é Notre Dame em Paris, e o ponto de partida será a estação ferroviária Gare de l’Est (48.87697775149635, 2.3592247806755564).

O motorista sai da estação a cerca de 16 minutos ao norte de Notre Dame. Notre Dame é uma atração turística famosa em uma ilha com acesso por ponte, algumas ruas de mão única e nenhum estacionamento grande disponível nas proximidades. Portanto, esse será um desafio interessante.
Solicitação da API Places
Este exemplo de solicitação da API Places usa a "Pesquisa de texto" para encontrar Notre Dame. Consulte a documentação para desenvolvedores para mais detalhes. "YOUR_KEY" nesses exemplos é a chave de API que você tem para as APIs Places e Directions da Plataforma Google Maps ativadas no console do Google Cloud. Para uma explicação mais detalhada, consulte a documentação sobre como começar a usar a Plataforma Google Maps.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
A resposta à solicitação acima fornece as seguintes coordenadas de latitude e longitude:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Como você pode ver, as coordenadas realmente indicam Notre Dame.
![]() |
![]() |
Como desenvolvedor ou provedor de serviços, é uma boa ideia perguntar automaticamente ao motorista: "Procurando estacionamento perto de Notre Dame?". A experiência do usuário será diferente dependendo do dispositivo e da tela, mas um texto pop-up sutil que desaparece após um curto período pode valer a pena considerar nesse caso. Para encontrar estacionamento perto de Notre Dame, faça uma pesquisa de texto da API Places com os parâmetros de tipo "parking" e raio "300" definidos. Esse exemplo vai enviesar os resultados para áreas de estacionamento em um raio de 300 metros de Notre Dame.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
O primeiro resultado é "Parking Saemes Maubert-Lagrange" em 48.850591, 2.3486436. Vamos usar esse local na próxima parte, em que faremos uma solicitação da API Directions.
Solicitação da API Directions
Para encontrar o trajeto da estação até um estacionamento perto de Notre Dame, você precisa fazer uma solicitação da API Directions. Basta definir os parâmetros de origem e destino. Consulte a documentação do desenvolvedor para mais opções.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
A resposta da API Directions geralmente contém várias sugestões de rotas. Cada rota consiste em vários "trechos", que contêm várias "etapas" mostrando a distância e as coordenadas do trajeto. Para encontrar as coordenadas finais acessíveis de carro, use o campo "end_location" da última etapa de um último trecho em um trajeto selecionado.
Talvez esse local não pareça a primeira opção, mas, ao olhar o mapa ou o Google Street View, você vai descobrir que ele fica a uma curta distância a pé da Notre Dame, cerca de 6 a 7 minutos.

Rota a pé da área de estacionamento até Notre Dame
Resumo do exemplo 1
Como você pode ver, encontrar uma área de estacionamento para um carro requer apenas algumas chamadas de API e mostrar a sugestão ao motorista. Isso economiza tempo para os usuários, já que eles não precisam dirigir em ruas de mão única ou tentar encontrar um lugar para deixar o carro em uma atração turística lotada. Como um resumo, fizemos as seguintes solicitações de API:
- Uma solicitação da API Places para encontrar as coordenadas de Notre Dame
- Uma solicitação da API Places para encontrar uma área de estacionamento em um raio de 300 metros dessas coordenadas
- Uma solicitação da API Directions para encontrar um trajeto até a área de estacionamento
Exemplo 2: como guiar até um terminal em um aeroporto grande

"types" : [ "airport", "point_of_interest", "establishment" ],
No entanto, quem já visitou um aeroporto grande sabe que leva muito tempo para fazer a transferência entre terminais se você chegar no lugar errado. Nesse caso, como o tipo do resultado da pesquisa é "aeroporto", é útil fazer uma consulta de acompanhamento automática para pesquisar "terminal" usando a localização do aeroporto de Heathrow, em Londres (51.47016927594547, -0.45432767852489075). No exemplo, também é possível ver a limitação opcional do raio de pesquisa de 3.000 metros.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
A consulta acima nos dá uma lista dos terminais e pontos de desembarque individuais nesses terminais. Na lista de resultados, encontramos "Terminal 5 do Aeroporto de Heathrow, Londres" e o ID do lugar:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Usando o parâmetro "place_id", podemos informar à API Directions que estamos tentando chegar a um lugar em vez de coordenadas arbitrárias.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Assim como no exemplo anterior, ao ler todas as etapas na resposta JSON, você encontra a última parte da jornada e as coordenadas de latitude e longitude dos locais de destino (51.47079979999999,-0.4896765).

Resumo do exemplo 2
Assim como no exemplo anterior, o esforço de desenvolvimento para oferecer uma orientação melhor ao motorista é muito pequeno, e os benefícios em tempo economizado para o motorista são facilmente medidos. Fizemos as seguintes solicitações:
- Uma solicitação da API Places para encontrar o aeroporto de Heathrow
- Uma solicitação da API Places para encontrar todos os terminais próximos às coordenadas do aeroporto de Heathrow
- Uma solicitação da API Directions para receber um trajeto até o terminal 5
Conclusão
Como você pode ver, o esforço de desenvolvimento necessário para oferecer um serviço premium aos clientes que viajam de carro é pequeno e permite demonstrar facilmente como você está pensando nas necessidades deles.
Para fins de desenvolvimento, você pode usar muitas das bibliotecas e ferramentas disponíveis para ajudar a criar os serviços para seus clientes. Confira nosso repositório público do GitHub para a Plataforma Google Maps.
Próximas ações
- Navegação de ambientes externos para internos
- Como criar um recurso de validação de local com o Google Maps
Autor principal
Mikko Toivanen | Engenheiro de soluções da Plataforma Google Maps