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 Maps JavaScript.

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 les fonctionnalités de mappage de clés API Maps API for Business ou Google JavaScript MapsGoogle, 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.

Figure 1. Page de carte

Procédure

1. Google Étant donné que les API Maps pour les licences Business ne sont plus disponibles à partir de Google, utilisez l’une des procédures suivantes selon que vous disposez ou non d’une licence.
   Remarque :

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

   Une licence Maps API for Business existante Google est-elle disponible ?	Tâches
   Licence existante disponible	Dans l' Propriétés système > Google Maps Forme de propriété : Dans le champ google.maps.client , entrez l’ID client de votre organisation. Cet ID provient de Google et commence par gme-, par exemple gme-nomentreprise. Dans le champ google.maps.private.key , saisissez la clé privée pour Google Maps API for Business. Un exemple de clé codée est vNIXE0xscrmjlyV-12Nj_BvUPaw=. Cette Now Platform® clé est nécessaire pour obtenir des estimations précises du temps de conduite à partir de certaines fonctionnalité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. Remarque : Consultez le Guide de démarrage sur le site Web pour plus d’informations sur l’obtention Google d’une clé, à l’aide de l’API et les conditions d’utilisation pertinentes.
   Aucune licence disponible	Obtenir une clé API Google JavaScript pour Maps à partir de Google. Dans l' Propriétés système > Google Maps , saisissez la clé API dans le champ de google.maps.key . La géolocalisation dans le utilise la clé API, que Google Plans utilise également pour la géolocalisation et la Now Platform® facturation des vues 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 Google Maps API for Business et Google la clé API Maps JavaScript, reportez-vous à https://developers.google.com/maps/gmp-get-started.
2. Une fois que vous avez terminé et enregistré la configuration, créez des pages de carte ou utilisez les pages par défaut incluses avec le module d’extension.
   Les pages de carte définissent les données qui apparaissent sur la carte et l’apparence des liens. Pour obtenir un didacticiel sur l’affichage de tous les marqueurs associés à vos enregistrements, consultez l’article de blog Afficher les marqueurs de carte sur Google Maps à l’adresse .ServiceNow Community

   Propriété	Description
   google.maps.auto_close	Si vrai, ferme automatiquement une fenêtre d’informations sur la 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 l’API Maps pour entreprise Type : chaîne Valeur par défaut : gme-servicenow Emplacement : Propriétés système > Google Maps
   google.maps.private.key	Clé privée pour Google API Maps for Business. Cette clé active la fonctionnalité de géolocalisation, qui localise précisément les utilisateurs dans le système, à l’aide des données de leurs équipements mobiles. Type : chaîne Valeur par défaut : vide Emplacement : Propriétés système > Google Maps
   google.maps.version	Numéro de version de l’installation actuelle de Google Maps API for Business. 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 Clé API Maps API for Business ou Google Maps JavaScript 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.latitude	Latitude de départ sur la carte. Cette valeur détermine la position de départ affichée dans Google les 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 les configurations suivantes :
   1. Accédez à la Propriétés système > Tous.
   2. Définissez les valeurs des propriétés système suivantes :

      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’existe aucun champ permettant de suivre 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 à laquelle les coordonnées ont été récupérées pour la dernière fois est renseignée correctement dans la table Configuration de l’actualisation des coordonnées de la carte [cmn_coordinate_refresh_config]. Reportez-vous à l’exemple de script correctif Mettre à jour les coordonnées mises à jour sur le champ pour mettre à jour les valeurs dans le champ coordinates_retrieved_on .
   5. Accédez à la Définition du système > Travaux planifiés.
   6. Ouvrez l’enregistrement Actualiser 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 :

      Veillez à 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 en fonction de votre région, effectuez les configurations suivantes.
   1. Accédez à la Administration utilisateurs > Utilisateurs.
   2. Sélectionnez et affectez le code de pays approprié pour l’utilisateur requis.
      Remarque :

      Si le code de pays requis n’est pas disponible, ajoutez l’entrée du dictionnaire. Assurez-vous d’utiliser les codes pays ISO 3166-1. Par exemple, le code pays de Maroc est MA.
   3. Accédez à la Propriétés système > Google Maps.
   4. Cochez la case Oui de l’option Activer 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 sur 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.