Há uma versão mais recente deste documento com exemplos de como usar a nova API Places e a API Routes.
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 a um shopping. Ao ir para um aeroporto, o motorista está tentando chegar a um terminal ou um ponto de entrega, e não ao centro do complexo do aeroporto. Da mesma forma, um estacionamento ao lado do shopping 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 para onde ele está indo e, em seguida, ofereça destinos opcionais perto desse 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 local fornecidos pela Plataforma Google Maps.
Visualização simplificada dos sistemas envolvidos ao guiar o motorista até um local com um carro
Vamos mostrar como usar as APIs Places e Directions em sequência ou combinação para identificar o local certo para estacionar ao lado do seu destino. Essa solução tem como objetivo eliminar a incerteza e as várias interações para encontrar um lugar para estacionar enquanto se aproxima do destino final. Vamos conferir 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 à via para que uma rota precise ser recuperada separadamente. O destino é Notre Dame em Paris, e como ponto de partida vamos usar 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. A Notre Dame é uma atração turística famosa em uma ilha com acesso por ponte, algumas ruas de mão única e sem estacionamento grande disponível nas proximidades. Portanto, esse é um desafio interessante.
Solicitação da API Places
Este exemplo de solicitação da API Places usa a "pesquisa de texto" para encontrar a Notre Dame. Consulte a documentação para desenvolvedores para saber mais. A "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 apontam para Notre Dame.
|
|
Como desenvolvedor ou provedor de serviços, é uma boa ideia perguntar automaticamente ao motorista: "Procurando estacionamento perto da Notre Dame?". A experiência do usuário será diferente dependendo do dispositivo e da tela, mas um texto de pop-up sutil que desaparece após um curto período pode ser considerado neste caso. Para encontrar estacionamento perto de Notre Dame, faça uma pesquisa de texto na API Places com o tipo "estacionamento" e os parâmetros de raio "300" definidos. Este exemplo vai enviesar os resultados para áreas de estacionamento a até 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 a rota da estação até uma área de estacionamento perto da 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 Direction geralmente contém várias sugestões de trajeto. Cada rota é composta por vários "trechos", que contêm várias "etapas" mostrando a distância e as coordenadas da viagem. Para encontrar as coordenadas finais acessíveis com um carro, use o campo "end_location" da última etapa de uma última etapa em uma rota que você selecionou.
Esse local pode não parecer a primeira escolha, mas, quando você olha o mapa ou o Google Street View, percebe que ele fica a uma curta distância a pé, cerca de 6 a 7 minutos, da Notre Dame.
Rota de caminhada da área de estacionamento até a 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 seus 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 movimentada. Como 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 a até 300 metros dessas coordenadas
- Uma solicitação da API Directions para encontrar um trajeto até a área de estacionamento
Exemplo 2: como chegar a um terminal em um aeroporto grande
"types" : [ "airport", "point_of_interest", "establishment" ],
No entanto, qualquer pessoa que tenha visitado um aeroporto grande sabe que leva um tempo significativo para fazer a transferência entre terminais se você chegar no local errado. Nesse caso, como o tipo de resultado da pesquisa é "aeroporto", é útil fazer a consulta de acompanhamento automático para pesquisar "terminal" usando a localização do aeroporto de Heathrow, em Londres (51.47016927594547, -0.45432767852489075). No exemplo, você também pode conferir 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 mostra uma lista dos terminais e dos pontos de entrega individuais nesses terminais. Na lista de resultados, encontramos "London Heathrow Airport Terminal 5" 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 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, lendo todas as etapas na resposta JSON, você vai 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 melhores 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 fornecer um serviço premium aos clientes que viajam de carro é bastante 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 criar serviços para seus clientes. Confira nosso repositório do GitHub para a Plataforma Google Maps (link em inglês) disponível publicamente.
Próximas ações
Autor principal
Mikko Toivanen | Engenheiro de soluções da Plataforma Google Maps