For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mapas do Google e geocodificação

Crie e configure Chaves de API do Google Maps para o Navixy On-Premise. Configure chaves separadas para mapas da interface do usuário, serviços GIS e notificações por e-mail.

Para usar o Google Maps com o Navixy On-Premise, você precisa obter Chaves de API válidas do Google Maps. Esta página da documentação fornece um guia passo a passo sobre como criar Chaves de API do Google Maps e configurá-las para uso com a plataforma Navixy.

O guia vai orientá-lo no processo de configurar uma conta no Google Cloud Console, criar um novo projeto, gerar as Chaves de API necessárias e aplicá-las à configuração da sua instância Navixy. Seguindo este guia, você poderá integrar facilmente o Google Maps com o Navixy On-Premise e aproveitar ao máximo os recursos avançados de mapeamento da plataforma.

Criação de Chaves de API do Google

Para criar Chaves de API do Google para uso com a plataforma Navixy, siga o guia abaixo. Observe que as Chaves de API do Google estão associadas à sua conta e estão sujeitas à política de uso de API do Google. Para mais informações, consulte os links abaixo:

Configurando conta e projeto

  1. Acesse a Google Cloud Console página e faça login usando as credenciais da sua conta Google. Se você não tiver uma conta, poderá criar uma.

  2. As Chaves de API são criadas dentro de um projeto. Se você já tiver um projeto, poderá selecioná-lo na lista. Se não tiver nenhum projeto existente, clique em "Create project" para criar um novo.

  3. Dê um nome apropriado ao seu projeto e clique no botão "Create" para criar um novo projeto

  1. Certifique-se de que o projeto recém-criado esteja selecionado e clique em “Enable APIs and Services”. Você será levado à biblioteca de APIs do Google.

  2. Digite o nome da API de que você precisa, selecione-a e clique em “Enable”. Neste caso, estamos adicionando Maps Javascript API (usado para o Google Maps)

  3. Repita o processo para as APIs de que você precisa. O Navixy utiliza um total de 5 APIs:

  • Google Maps JavaScript API - Google Maps na interface

  • Google Maps Geocoding API - Geocodificação

  • Google Maps Geolocation API - processamento de ponto LBS

  • Google Maps Directions API - criação de rota

  • Google Static Maps API - mapas estáticos no e-mail

Certifique-se de que todas as APIs ativadas sejam exibidas no seu painel:

Gerando chaves do Google

Para habilitar toda a gama de funcionalidades do Navixy, você precisará de um total de três Chaves de API:

  • Chave #1 para exibir mapas na interface do usuário

  • Chave #2 para acessar serviços GIS (geocodificação, roteamento e geolocalização)

  • Chave #3 para exibir mapas estáticos do Google em notificações por e-mail

Gerando a chave #1 do Google para Mapas na interface

  1. Vá para a Credentials aba

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

  4. Pressione Restrict key para fazer alterações, você será levado a uma página de configuração

  5. Dê um nome à chave para que seja mais fácil distingui-la das outras

  6. Em Application restrictions selecione HTTP referrer e especifique o domínio que você usa para a plataforma. Ex. contoso.com/* gps.contoso.com/*

  7. Em API restrictions selecione Restrict key e escolha Maps JavaScript API

  8. Pressione Salvar para aplicar as alterações

Gerando a chave Google #2 para Geocodificação, Roteamento e Geolocalização

  1. Vá para a Credentials aba

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

  4. Pressione Restrict key para fazer alterações, você será levado a uma página de configuração

  5. Dê um nome à chave para que seja mais fácil distingui-la das outras

  6. Em Application restrictions selecione Endereços IP e especifique o IP público do seu servidor

  7. Em API restrictions selecione Restrict key e escolha Maps Geocoding API, Maps Geolocation API, Maps Directions API

  8. Pressione Salvar para aplicar as alterações

Gerando a chave Google #3 para mapas estáticos em notificações por e-mail

  1. Vá para a Credentials aba

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

  4. Pressione Restrict key para fazer alterações, você será levado a uma página de configuração

  5. Dê um nome à chave para que seja mais fácil distingui-la das outras

  6. Em Application restrictions selecione HTTP referrer e especifique o domínio que você usa para a plataforma. Ex. contoso.com/* gps.contoso.com/*

  7. Em API restrictions selecione Restrict key e escolha Maps Static API

  8. Pressione Salvar para aplicar as alterações

Para a chave Google #3, você também precisará de um segredo de assinatura de URL. Consulte o guia abaixo para gerar um segredo de assinatura de URL para a sua chave de mapas estáticos:

  1. Vá para o Dashboard

  2. Role até a lista de APIs e clique em Maps Static API

  3. Você será redirecionado para uma nova página.

  4. Clique no Credentials menu

  5. Verifique se Maps Static API está selecionado

  6. Role até o segredo de assinatura de URL para ver o atual.

Aplicando Chaves de API do Google Maps

Conforme descrito acima, recomendamos gerar três Chaves de API do Google Maps e atribuir a elas os seguintes serviços de API do Google:

Chave de API do Google Maps #1 – deve ser restringida por HTTP referrer, que é a URL da sua interface do usuário:

  • Google Maps JavaScript API

  • Google Street View Image API

Chave de API do Google Maps #2 – deve ser restringida pelo IP do servidor:

  • Google Maps Geocoding API

  • Google Maps Geolocation API

  • Google Maps Directions API

Chave de API do Google Maps #3 – deve ser restringida por HTTP referrer, que é a URL da sua interface do usuário:

  • Google Static Maps API (você também precisa segredo de assinatura de URL para esta chave)

As três chaves serão armazenadas no banco de dados. Elas devem ser inseridas na tabela dealer_service_credentials do google DB com a seguinte consulta:

Se você não quiser usar o Google Maps para determinados serviços, poderá omitir da consulta as chaves de que não precisa. Por exemplo, use esta consulta para aplicar apenas a terceira chave:

Reinicie os serviços

restart-navixy

Atualizado

Isto foi útil?