Configurer l'API Google Maps

Vous activez la fonctionnalité de géolocalisation à l’aide des entrées appropriées d’une Google licence Maps API for Business ou d’une Google clé API JavaScript Maps.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Vous pouvez générer des cartes à l’aide de JavaScript de base, et elles sont suffisamment flexibles pour afficher même les requêtes les plus compliquées. Ces cartes utilisent l’API standard Google Maps pour entreprise ou Google les fonctionnalités de mappage de clé de l’API JavaScript Maps, y compris divers types de liens vers les enregistrements de votre instance. L’utilisation de cette fonctionnalité nécessite l’installation du module d’extension Google Maps.

Important :

À partir de mai 2026, Google dépréciera l’utilisation de l’ID client pour authentifier les demandes à Google Maps. À partir de cette date, les clés API seront la seule méthode d’authentification prise en charge. Si votre application continue d’utiliser l’ID client (par exemple, via le google.maps.method property), les demandes Google Maps échoueront. Pour plus d’informations, consultez le Guide de migration des ID clients.

Mettez à jour votre configuration pour vous authentifier à l’aide d’une clé API uniquement (c’est-à-dire définie google.maps.method sur clé). Consultez les descriptions et google.maps.key.geocoding les propriétés pour plus d’informations sur l’authentification google.maps.key basée sur la clé API.

Procédure

1. Google Les licences Maps API pour Business ne sont plus disponibles à partir de Google, utilisez donc l’une des procédures suivantes selon qu’elles disposent ou non d’une licence existante.
   Remarque :

   Vous devez utiliser votre propre clé API JavaScript Google Maps à partir de Google et ne pas utiliser de ServiceNow AI Platform® clé générée.

   Licence existante Google de l’API de cartes pour entreprise disponible ?	Tâches
   Licence existante disponible	Dans le Propriétés système > Google Maps Formulaire de propriété : Dans le champ google.maps.client , saisissez l’ID client de votre organisation. Cet ID provient de Google et commence par gme-, comme gme-mycompanyname. Dans le champ google.maps.client.key , saisissez la clé privée de Google l’API Maps pour entreprise. Un exemple de clé codée est vNIXE0xscrmjlyV-12Nj_BvUPaw=. Cette ServiceNow AI Platform® clé est nécessaire pour récupérer des estimations précises du temps de trajet pour certaines entités de Google géolocalisation. Renseignez les valeurs restantes sur le formulaire. Configurez vos cartes à l’aide des définitions de propriétés de la table. Important : La configuration basée sur l’ID client Google Maps est en cours d’obsolescence. L’authentification par ID client ne sera plus prise en charge à partir de mai 2026 et les configurations qui en dépendent ne fonctionneront plus.
   Aucune licence disponible	Obtenez une Google clé API Maps JavaScript à partir de Google. Dans le Propriétés système > Google Maps , entrez la clé API dans le champ google.maps.key . La géolocalisation dans le ServiceNow AI Platform® utilise la clé API, que Google Maps utilise également pour la géolocalisation et la facturation de la vue de carte. Renseignez les valeurs restantes sur le formulaire. Configurez vos cartes à l’aide des définitions de propriétés de la table.

   Pour en savoir plus sur l’API Maps pour les entreprises et Google la Google clé API JavaScript Maps, consultez https://developers.google.com/maps/gmp-get-started.
2. Une fois la configuration terminée et enregistrée, créez des pages de carte ou utilisez les pages par défaut incluses dans le module d’extension.
   Les pages de la carte définissent les données qui s’affichent sur la carte et l’apparence des liens. Pour un didacticiel sur la façon d’afficher tous les marqueurs liés à vos enregistrements, consultez l’article de blog Afficher les marqueurs de carte sur Google Maps sur le .ServiceNow Community

   Propriété	Description
   google.maps.method	Définit la méthode d’authentification à utiliser pour Google Maps. Type : chaîne Valeur par défaut : key Emplacement : Propriétés système > Google Maps
   google.maps.auto_close	Si vrai, ferme automatiquement une fenêtre d’informations de carte avant d’en ouvrir une nouvelle. Type : vrai/faux Valeur par défaut : true Emplacement : Propriétés système > Google Maps
   google.maps.client	ID client pour Google API Maps pour entreprise. Type : chaîne Valeur par défaut : gme-servicenow Emplacement : Propriétés système > Google Maps
   google.maps.map_id	ID de carte pour Google Maps utilisé pour le style des cartes basées sur le cloud, les cartes vectorielles et les marqueurs avancés. Pour obtenir votre ID de carte, consultez Comment créer des ID de carte. Type : chaîne Valeur par défaut : vide Emplacement : Propriétés système > Google Maps
   google.maps.client.key	Clé privée pour Google l’API Maps pour entreprise. Cette touche active la fonctionnalité de géolocalisation, qui localise précisément les utilisateurs dans le système, à l’aide des données de leurs appareils mobiles. Type : chaîne Valeur par défaut : vide Emplacement : Propriétés système > Google Maps
   version google.maps.version	Numéro de version de l’installation actuelle de l’API Google Maps pour entreprise. Type : chaîne Valeur par défaut : numéro de la version actuelle Emplacement : Propriétés système > Google Maps
   google.maps.key	Google API Maps pour entreprise ou Google API JavaScript Maps Clé liée à l’URL du serveur. Cette clé autorise l’utilisation de l’API Google Maps pour le développement. Type : chaîne Valeur par défaut : vide Emplacement : Propriétés système > Google Maps
   google.maps.key.géocodage	API Google Maps pour entreprise ou clé API JavaScript Google Maps liée à l’URL du serveur. Cette clé est utilisée pour effectuer des demandes de géocodage. Type : chaîne Valeur par défaut : vide Emplacement : Propriétés système > Google Maps
   google.maps.latitude	Latitude de départ sur la carte. Cette valeur détermine la position de départ affichée dans Google Cartes. Type : chaîne Valeur par défaut : 36.008522 Emplacement : Propriétés système > Google Maps
   google.maps.longitude	Longitude de départ sur la carte. Cette valeur détermine la position de départ affichée dans Google les pages Cartes. Type : chaîne Valeur par défaut : -95,221764 Emplacement : Propriétés système > Google Maps
   google.maps.max_éléments	Nombre maximal d’éléments à afficher sur la carte. Type : nombre entier Valeur par défaut : 500 Emplacement : Propriétés système > Google Maps
   google.maps.table	Table utilisée par la carte. La table nécessite les champs suivants : nom, longitude, latitude. Type : chaîne Valeur par défaut : cmn_location Emplacement : Propriétés système > Google Maps
   google.maps.zoom	Niveau de zoom de départ de la carte (1 étant le plus bas) Type : chaîne Valeur par défaut : 4 Emplacement : Propriétés système > Google Maps

3. Effectuez ces configurations :
   1. Accédez à la Propriétés système > Tous.
   2. Définissez les valeurs de ces propriétés système :

      Propriété système	Description
      google.maps.refresh.latlong.duration	Nombre de jours après lesquels les détails de l’emplacement sont mis à jour. Remarque : La valeur maximale est 30.
      google.maps.refresh.latlong.record_count_per_table	Nombre maximal d’enregistrements dans une table qui peuvent être traités à l’aide de la tâche planifiée en une seule actualisation.

   3. Spécifiez les tables qui stockent les détails de l’emplacement dans la table Configuration de l’actualisation des coordonnées de la carte [cmn_coordinate_refresh_config].
   4. S’il n’y a aucun champ permettant de suivre la date de la dernière récupération des coordonnées dans vos tables :
      1. Créez le champ coordinates_retrieved_on du type Date/Heure dans vos tables.
      2. Assurez-vous que la valeur du champ qui suit l’heure de la dernière récupération des coordonnées est correctement renseignée dans la table Configuration de l’actualisation des coordonnées de la carte [cmn_coordinate_refresh_config]. Reportez-vous à l’exemple de script correctif Mettez à jour les coordonnées mises à jour dans le champ pour mettre à jour les valeurs du champ coordinates_retrieved_on .
   5. Accédez à la Définition du système > Travaux planifiés.
   6. Ouvrez l’enregistrement, actualisez les informations de latitude et de longitude des enregistrements.
   7. Sélectionnez la case à cocher Activé.
   8. Spécifiez la fréquence à laquelle les détails de l’emplacement doivent être actualisés en fournissant des détails de fréquence dans Intervalle d’exécution et de répétition.
      Remarque :

      Assurez-vous d’actualiser les détails de l’emplacement au moins une fois tous les 30 jours.
4. Facultatif : Pour accéder aux Google cartes à partir de l’instance ServiceNow basée sur votre région, effectuez ces configurations.
   1. Accédez à la Administration utilisateurs > Utilisateurs.
   2. Sélectionnez et affectez le code de pays approprié à l’utilisateur requis.
      Remarque :

      Si le code du pays requis n’est pas disponible, ajoutez l’entrée de dictionnaire. Assurez-vous d’utiliser les codes de pays ISO 3166-1. Par exemple, le code de pays du Maroc est MA.
   3. Accédez à la Propriétés système > Google Maps.
   4. Cochez la case Oui pour Activez cette propriété uniquement lorsque vous souhaitez modifier le comportement de Google Map en fonction d’une région. La région est remplie à partir de la valeur du champ « Code du pays » de l’utilisateur actuel dans sys_user enregistrement. La valeur du code pays de l’enregistrement sys_user doit être conforme aux attentes du code régional de Google Map. La plupart des identificateurs de région Unicode sont identiques aux codes ISO 3166-1, à quelques exceptions notables. Vérifiez correctement les codes avant d’apporter des modifications.
   5. Cliquez sur Enregistrer.