Conecte o Google Maps ao seu app do MonstarX

Mapas, busca de lugares e rotas do Google.

Tipo

Para o seu app

Categoria

Mapas e lugares

Conecte com

Chave de API

O Google Maps Platform é o serviço do Google para dados de mapas: os lugares, endereços, horários de funcionamento, avaliações e rotas que estão por trás do Google Maps. Conecte-o e o seu app consegue consultar esses dados.

Você não precisa dele para ter um mapa. Todo app do MonstarX consegue mostrar um mapa de ruas que dá para arrastar e ampliar, com marcadores, de graça. Veja Mapas no seu app. O Google Maps serve para o que esses mapas não sabem sozinhos.

O que você pode criar com ele?

• Preenchimento automático de endereço: a pessoa começa a digitar um endereço e escolhe entre as sugestões do Google.
• Busca de lugares: “cafés perto de mim”, “fisioterapeutas em Pinheiros”, mostrados em lista e no mapa.
• Dados de empresas: horário de funcionamento, telefone, nota e avaliações de um lugar.
• Endereços no mapa: transformar um endereço digitado em um marcador (isso se chama geocodificação).
• Rotas de carro entre dois lugares.

Antes de começar

• Uma conta do Google Cloud com uma conta de faturamento vinculada. O Google Maps Platform exige uma, mesmo dentro da cota mensal gratuita (veja os preços do Google).
• Um projeto do Google Cloud para o seu app.

Pegue sua chave

1. No console do Google Cloud, escolha ou crie um projeto e abra o Google Maps Platform.

2. Ative as APIs que o seu app vai usar. Para as ideias acima: Maps JavaScript API e Places API (New) para busca e preenchimento automático, Geocoding API para endereços e Routes API para rotas.

3. Abra Chaves e credenciais e crie uma chave de API. Copie a chave (ela começa com AIza).

4. Restrinja a chave. Em Restrições de API, permita apenas as APIs que você ativou.

Cuidado

Esta chave chega ao navegador, então qualquer pessoa poderia copiá-la. Restringi-la às suas APIs impede que ela seja usada para outras coisas. O Google também permite restringir uma chave aos endereços do seu site, mas aí o Google recusa as consultas que o seu app faz pelo servidor, como transformar um endereço em uma posição no mapa. Se o seu app faz essas consultas, restrinja só por API ou peça ao MonstarX para usar uma segunda chave no servidor.

Conecte no MonstarX

1. Abra seu projeto e clique em Backend na barra superior e depois em Nuvem.

2. Em Conectores, clique em Conectar ao lado do Google Maps.

3. Cole a chave em Chave de API.

   

4. Clique em Conectar Google Maps. A linha mostra Conectado e a prévia reinicia com a chave.

Peça ao MonstarX para usar

Você digita	O que acontece
“No formulário de agendamento, complete o endereço automaticamente com o Google Maps.”	As sugestões aparecem enquanto a pessoa digita; o endereço escolhido é salvo.
“Adicione uma página Encontre um estúdio perto de você com a busca do Google Places.”	Uma caixa de busca e resultados com nomes, endereços e notas, marcados no mapa.
“Mostre o horário de funcionamento e a nota de cada café, vindos do Google.”	Dados de cada lugar trazidos do Google.
“Mostre aos motoristas a rota do depósito até cada endereço de entrega.”	Uma rota com a distância e o tempo.

Segurança e privacidade

• A chave é uma chave pública: ela é usada no navegador das pessoas, então não fica escondida. O que a protege são as restrições no Google Cloud.
• Ela fica guardada apenas com este app. O nome dela aparece em Backend›Segredos.
• Só o proprietário do projeto pode conectar, atualizar ou desconectar o Google Maps.
• Para trocar a chave, crie uma nova no Google Cloud, clique em Atualizar chaves na linha do Google Maps, cole a chave e clique em Salvar chaves. Publique de novo e depois exclua a chave antiga.

Bom saber

• Seus mapas mantêm o visual: o Google Maps acrescenta dados e busca ao seu app, não os blocos de mapa do Google.
• O Google cobra por solicitação acima da cota mensal gratuita. Configure um alerta de orçamento no faturamento do Google Cloud.
• Prefere visão de satélite ou os estilos de mapa do Mapbox? Veja Mapbox.
• Os termos do Google têm regras para exibir os dados de lugares, como dar o crédito ao Google ao lado dos resultados. Se o seu app lista lugares, peça ao MonstarX para adicionar o crédito.

Perguntas frequentes

Preciso do Google Maps para mostrar um mapa?

Não. Todo app do MonstarX consegue mostrar mapas de graça, sem chave. Conecte o Google Maps só para lugares, preenchimento automático, dados de empresas ou rotas.

Por que o Google diz que a API não está ativada?

Cada serviço do Google Maps precisa ser ativado no seu projeto do Google Cloud. Ative o que aparece no erro, como a Places API (New).

É seguro a chave ficar no navegador?

Sim, quando ela está restrita às APIs que o seu app usa. O Google projeta essas chaves para serem usadas em páginas da web.

Google Maps ou Mapbox?

Google Maps para lugares, dados de empresas e avaliações. Mapbox para estilos de mapa personalizados e visão de satélite. Os dois transformam endereços em marcadores e traçam rotas.

Veja também

Mapas no seu appMapas grátis, sem chave.

MapboxEstilos de mapa, satélite e geocodificação.

Conecte um serviço ao seu appComo funcionam os conectores do app.

Segredos e chaves de APIOnde as suas chaves ficam guardadas.