Google Maps et géocodage

Pour utiliser Google Maps avec Navixy On-premise, vous devez obtenir des clés API Google Maps valides. Cette page de documentation fournit un guide étape par étape sur la façon de créer des clés API Google Maps et de les configurer pour une utilisation avec la plateforme Navixy.

Le guide vous accompagnera dans le processus de création d'un compte Google Cloud Console, de création d'un nouveau projet, de génération des clés API nécessaires et de leur application à la configuration de votre instance Navixy. En suivant ce guide, vous pourrez intégrer facilement Google Maps avec Navixy On-premise et tirer pleinement parti des fonctionnalités avancées de cartographie de la plateforme.

Création des clés API Google

Pour créer des clés API Google à utiliser avec la plateforme Navixy, veuillez suivre le guide ci‑dessous. Veuillez noter que les clés API Google sont associées à votre compte et sont soumises à la politique d'utilisation des API de Google. Pour plus d'informations, veuillez vous référer aux liens ci‑dessous :

• Conditions d'utilisation des API Google Maps

• FAQ Goole Maps

Configuration du compte et du projet

1. Accédez à la Google Cloud Console page web et connectez‑vous en utilisant vos identifiants de compte Google. Si vous n'avez pas de compte, vous pouvez en créer un.

2. Les clés API sont créées au sein d'un projet. Si vous avez déjà un projet, vous pouvez le choisir dans la liste. Si vous n'avez pas de projet existant, cliquez sur "Create project" pour en créer un nouveau.

3. Nommez votre projet de manière appropriée et cliquez sur le bouton "Create" pour créer un nouveau projet

1. Assurez‑vous que votre projet nouvellement créé est sélectionné et cliquez sur « Enable APIs and Services ». Vous serez dirigé vers la bibliothèque d'API Google.

2. Tapez le nom de l'API dont vous avez besoin, sélectionnez‑la et cliquez sur « Enable ». Dans ce cas, nous ajoutons Maps Javascript API (utilisé pour google maps)

3. Répétez le processus pour les API dont vous avez besoin. Navixy utilise un total de 5 API :

• Google Maps JavaScript API - Google maps dans l'interface utilisateur

• Google Maps Geocoding API - Géocodage

• Google Maps Geolocation API - Traitement des points LBS

• Google Maps Directions API - Création d'itinéraires

• Google Static Maps API - Cartes statiques dans les e‑mails

Assurez‑vous que toutes les API activées sont affichées dans votre tableau de bord :

Génération des clés Google

Pour activer l'ensemble des fonctionnalités de Navixy, vous aurez besoin d'un total de trois clés API :

• Clé n°1 pour afficher les cartes dans l'interface utilisateur

• Clé n°2 pour accéder aux services SIG (géocodage, routage et géolocalisation)

• Clé n°3 pour afficher des Google Maps statiques dans les notifications par e‑mail

Génération de la clé Google n°1 pour les cartes dans l'interface

1. Allez à Credentials onglet

2. Appuyez sur Create credentials et sélectionnez API key

3. La clé s'affichera dans une nouvelle fenêtre

4. Appuyez sur Restrict key pour effectuer des modifications, vous serez dirigé vers une page de configuration

5. Nommez la clé afin qu'il soit plus facile de la distinguer des autres

6. Dans Application restrictions sélectionnez HTTP referrer et spécifiez le domaine que vous utilisez pour la plateforme. Par exemple contoso.com/* gps.contoso.com/*

7. Dans API restrictions sélectionnez Restrict key et choisissez Maps JavaScript API

8. Appuyez sur Save pour appliquer les modifications

Génération de la clé Google n°2 pour le géocodage, le routage et la géolocalisation

1. Allez à Credentials onglet

2. Appuyez sur Create credentials et sélectionnez API key

3. La clé s'affichera dans une nouvelle fenêtre

4. Appuyez sur Restrict key pour effectuer des modifications, vous serez dirigé vers une page de configuration

5. Nommez la clé afin qu'il soit plus facile de la distinguer des autres

6. Dans Application restrictions sélectionnez IP adresses et spécifiez l'IP publique de votre serveur

7. Dans API restrictions sélectionnez Restrict key et choisissez Maps Geocoding API, Maps Geolocation API, Maps Directions API

8. Appuyez sur Save pour appliquer les modifications

Génération de la clé Google n°3 pour les cartes statiques dans les notifications par e‑mail

1. Allez à Credentials onglet

2. Appuyez sur Create credentials et sélectionnez API key

3. La clé s'affichera dans une nouvelle fenêtre

4. Appuyez sur Restrict key pour effectuer des modifications, vous serez dirigé vers une page de configuration

5. Nommez la clé afin qu'il soit plus facile de la distinguer des autres

6. Dans Application restrictions sélectionnez HTTP referrer et spécifiez le domaine que vous utilisez pour la plateforme. Par exemple contoso.com/* gps.contoso.com/*

7. Dans API restrictions sélectionnez Restrict key et choisissez Maps Static API

8. Appuyez sur Save pour appliquer les modifications

Pour la clé Google n°3, vous aurez également besoin d'un URL signing secret. Veuillez vous référer au guide ci‑dessous pour générer un URL signing secret pour votre clé de cartes statiques :

1. Allez à la Dashboard

2. Faites défiler jusqu'à la liste des API et cliquez sur Maps Static API

3. Vous serez redirigé vers une nouvelle page.

4. Cliquez sur Credentials menu

5. Vérifiez que Maps Static API est sélectionné

6. Faites défiler jusqu'à URL signing secret pour voir votre secret actuel.

Application des clés API Google Maps

Comme décrit ci‑dessus, nous recommandons de générer trois clés API Google Maps et de leur attribuer les services Google API suivants :

Clé Google Maps n°1 – doit être restreinte par HTTP referrer, qui est l'URL de votre interface utilisateur :

• Google Maps JavaScript API

• Google Street View Image API

Clé Google Maps n°2 – doit être restreinte par l'IP du serveur :

• Google Maps Geocoding API

• Google Maps Geolocation API

• Google Maps Directions API

Clé Google Maps n°3 – doit être restreinte par HTTP referrer, qui est l'URL de votre interface utilisateur :

• Google Static Maps API (vous avez également besoin de URL signing secret pour cette clé)

Les trois clés seront stockées dans la base de données. Elles doivent être insérées dans la table dealer_service_credentials de google DB avec la requête suivante :

INSERT INTO dealer_service_credentials (dealer_id, service_type,credentials) VALUES (1, 'google', '{"maps_js_api_key":"FIRST_KEY_HERE","server_api_key":"SECOND_KEY_HERE","static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}';

Si vous ne souhaitez pas utiliser Google Maps pour certains services, vous pouvez omettre les clés dont vous n'avez pas besoin dans la requête. Par exemple, utilisez cette requête pour appliquer uniquement la troisième clé :

INSERT INTO google.dealer_service_credentials (dealer_id, service_type, credentials) VALUES (1, "google", '{"static_map_api_key":"THIRD_KEY_HERE", "static_map_crypto_key":"URL_SIGNING_SECRET_HERE"}');

Redémarrez les services

restart-navixy