Normalmente, quando o usuário está dirigindo até um ponto de interesse (PDI), ele precisa de navegação para um local próximo, como um estacionamento ou um ponto de acesso. Imagine um motorista que precisa ir a um aeroporto ou shopping. Ao ir para um aeroporto, o motorista está tentando chegar a um terminal ou ponto de desembarque, e não o centro do complexo do aeroporto. Da mesma forma, um estacionamento próximo ao shopping pode ser uma opção muito melhor para um usuário com carro. Nesse caso, ao desenvolver um app ou serviço para orientar o motorista, primeiro encontre o local para onde ele vai e ofereça destinos opcionais perto desse local. Essa abordagem permite que você forneça um serviço melhor aos seus clientes e demonstre que valoriza o tempo deles com um esforço de desenvolvimento pequeno, mas inteligente, que aproveita os dados de local fornecidos pela Plataforma Google Maps.
Visão simplificada dos sistemas envolvidos ao guiar o motorista para um local com um carro
Mostraremos como você pode usar a API Places e a API Directions em sequência ou combinação para identificar o local certo para estacionar perto do seu destino. O objetivo desta solução é eliminar incertezas e várias interações para encontrar um lugar para estacionar enquanto dirige uma vez mais perto do destino final. Vamos conferir em detalhes dois exemplos de como esses casos podem ser implementados.
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 seja recuperada separadamente. O destino é Notre Dame em Paris e, como ponto de partida, usaremos a estação de trem Gare de l’Est (48.87697775149635, 2.359224780675556).
O motorista sai da estação cerca de 16 minutos ao norte de Notre Dame. Notre Dame é uma atração turística famosa em uma ilha com acesso à ponte, algumas ruas de mão única e nenhum estacionamento grande disponível nas proximidades, então deve ser um desafio interessante.
Solicitação da API Places
Este exemplo de solicitação da API Places usa "pesquisa de texto" para encontrar Notre Dame. Consulte a documentação do desenvolvedor para ver detalhes. "YOUR_KEY" nesses exemplos é a chave de API das APIs Places e Directions da Plataforma Google Maps ativadas no console do Google Cloud. Se quiser uma explicação mais detalhada, consulte a documentação para 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,
},
...
As coordenadas indicam a Notre Dame.
|
|
Como desenvolvedor ou provedor de serviços, é uma boa ideia solicitar automaticamente ao motorista "Procurando um estacionamento perto de Notre Dame?". A experiência do usuário será diferente dependendo do dispositivo e da tela, mas nesse caso, vale a pena considerar um texto pop-up sutil que desaparece após um curto período. Para encontrar um estacionamento perto de Notre Dame, faça uma pesquisa de texto na API Places com os parâmetros do tipo "parking" e do raio "300" definidos. Este exemplo direcionará os resultados para áreas de estacionamento a 300 metros da 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” no número 48.850591, 2.3486436. Vamos usar esse local na próxima parte, em que fazemos uma solicitação da API Directions.
Solicitação da API Directions
Para encontrar a rota da estação até uma área de estacionamento próxima à Notre Dame, é preciso fazer uma solicitação à 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 Direction contém várias sugestões de trajeto. Cada trajeto é composto por vários "trechos" e eles contêm diversos "passos" que mostram a distância e as coordenadas do percurso. Para encontrar as coordenadas finais acessíveis de carro, use o campo "end_location" da última etapa do último trecho de um trajeto selecionado.
Este local pode não parecer a primeira escolha, mas, ao analisar o mapa ou o Google Street View, você descobre que ele está a uma curta distância a pé da Notre Dame, de 6 a 7 minutos.
Rota a pé da área de estacionamento até a Notre Dame
Resumo do exemplo 1
Como você pode notar, 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 estão dirigindo em ruas de mão única ou tentando encontrar um lugar para deixar o carro em uma atração turística lotada. Em resumo, fizemos as seguintes solicitações de API:
- Uma solicitação da API Places para encontrar coordenadas de Notre Dame
- Uma solicitação à API Places para encontrar uma área de estacionamento a 300 metros dessas coordenadas
- Uma solicitação à API Directions para encontrar uma rota até o estacionamento
Exemplo 2: orientação para um terminal em um grande aeroporto
"types" : [ "airport", "point_of_interest", "establishment" ],
No entanto, qualquer pessoa que tenha visitado qualquer aeroporto grande sabe que leva um tempo significativo para fazer baldeações entre terminais se você chegar ao local errado. Nesse caso, como o tipo de resultado da pesquisa é "aeroporto", é útil fazer o acompanhamento automático da consulta para pesquisar por "terminal" usando a localização do aeroporto da Heathrow de 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 gera uma lista dos terminais e dos pontos de entrega individuais nesses terminais. Na lista de resultados, podemos encontrar "Terminal 5 do aeroporto de Heathrow de Londres" e o ID de lugar:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Com o parâmetro "place_id", podemos informar à API Directions que estamos tentando chegar a um local em vez de algumas coordenadas arbitrárias.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Novamente, como no exemplo anterior, ao ler todas as etapas da resposta JSON, você encontrará a última parte da jornada e as coordenadas de latitude e longitude dos locais finais (51.47079979999999,-0.4896765).
Resumo do exemplo 2
Como no exemplo anterior, o esforço de desenvolvimento para fornecer orientações melhoradas ao motorista é muito pequeno, e os benefícios de tempo economizado para o motorista são facilmente medidos. Fizemos as seguintes solicitações:
- Uma solicitação à API Places para encontrar o aeroporto de Heathrow
- Uma solicitação à API Places para encontrar todos os terminais próximos às coordenadas do aeroporto de Heathrow
- Uma solicitação da API Directions para encontrar um trajeto para o terminal 5
Conclusão
Como você pode ver, o esforço de desenvolvimento necessário para fornecer um serviço premium para seus clientes que viajam de carro é bastante pequeno e permite demonstrar facilmente o que você pensa sobre as necessidades dos seus clientes.
Para fins de desenvolvimento, é possível usar muitas das bibliotecas e ferramentas disponíveis para ajudar a criar os serviços para seus clientes. Confira nosso repositório do GitHub para a Plataforma Google Maps disponível publicamente.
Próximas ações
Autor principal
Mikko Toivanen | Engenheiro de soluções da Plataforma Google Maps