Google Maps e geocodificação

Para usar o Google Maps com o Navixy On-premise, é necessário obter chaves de API do Google Maps válidas. Esta página de documentação fornece um guia passo a passo sobre como criar chaves de API do Google Maps e configurá-las para uso na plataforma Navixy.

O guia irá orientá-lo no processo de configuração de uma conta no Google Cloud Console, criação de um novo projeto, geração das chaves de API necessárias e aplicação delas na configuração da sua instância Navixy. Ao seguir este guia, você poderá integrar facilmente o Google Maps ao Navixy On-premise e aproveitar ao máximo os recursos avançados de mapeamento da plataforma.

Criando 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 das APIs do Google. Para mais informações, consulte os links abaixo:

Configurando conta e projeto

  1. Navegue até a Console do Google Cloud página da web 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, pode escolhê-lo na lista. Se não tiver projetos existentes, clique em "Create project" para criar um novo.

  3. Nomeie seu projeto de forma apropriada 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á direcionado para a biblioteca de APIs do Google.

  2. Digite o nome da API necessária, selecione-a e clique em “Enable”. Neste caso, estamos adicionando Maps Javascript API (usada para o google maps)

  3. Repita o processo para as APIs necessárias. O Navixy utiliza um total de 5 APIs:

  • Google Maps JavaScript API - Google maps na interface do usuário

  • Google Maps Geocoding API - Geocodificação

  • Google Maps Geolocation API - Processamento de pontos LBS

  • Google Maps Directions API - Criação de rotas

  • Google Static Maps API - Mapas estáticos em e-mail

Garanta que todas as APIs habilitadas sejam exibidas no seu painel:

Gerando chaves do Google

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

  • Chave #1 para exibição de mapas na interface do usuário

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

  • Chave #3 para exibição de Google Maps estáticos em notificações por e-mail

Gerando a chave do Google #1 para Maps na interface do usuário

  1. Acesse Credenciais guia

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

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

  5. Nomeie a chave para que seja mais fácil distingui-la das demais

  6. Em Restrições de aplicativo selecione HTTP referrer e especifique o domínio que você usa para a plataforma. Ex.: contoso.com/* gps.contoso.com/*

  7. Em Restrições de API selecione Restringir chave e escolha Maps JavaScript API

  8. Pressione Salvar para aplicar as alterações

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

  1. Acesse Credenciais guia

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

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

  5. Nomeie a chave para que seja mais fácil distingui-la das demais

  6. Em Restrições de aplicativo selecione Endereços IP e especifique o IP público do seu servidor

  7. Em Restrições de API selecione Restringir chave e escolha Maps Geocoding API, Maps Geolocation API, Maps Directions API

  8. Pressione Salvar para aplicar as alterações

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

  1. Acesse Credenciais guia

  2. Pressione Create credentials e selecione API key

  3. A chave será exibida em uma nova janela

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

  5. Nomeie a chave para que seja mais fácil distingui-la das demais

  6. Em Restrições de aplicativo selecione HTTP referrer e especifique o domínio que você usa para a plataforma. Ex.: contoso.com/* gps.contoso.com/*

  7. Em Restrições de API selecione Restringir chave e escolha Maps Static API

  8. Pressione Salvar para aplicar as alterações

Para a chave do Google #3 você também precisará de um URL signing secret. Consulte o guia abaixo para gerar um URL signing secret para 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á encaminhado para uma nova página.

  4. Clique em Credenciais menu

  5. Verifique se Maps Static API está selecionada

  6. Role até URL signing secret para ver o seu atual.

Aplicando as chaves de API do Google Maps

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

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

  • Google Maps JavaScript API

  • Google Street View Image API

Chave de API do Google Maps #2 – deve ser restrita por IP do servidor:

  • Google Maps Geocoding API

  • Google Maps Geolocation API

  • Google Maps Directions API

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

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

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

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

Reiniciar os serviços

restart-navixy

Atualizado

Isto foi útil?