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 : administrateur

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 des fonctionnalités de mappage de clés API Maps API for Business ou Google JavaScript MapsGoogle, y compris différents types de lien vers des enregistrements dans 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 Les licences Maps API for Business ne sont plus disponibles à partir de , Googlepar conséquent, selon que vous disposez ou non d’une licence, utilisez l’une des procédures suivantes.
   Remarque :

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

   Une licence Maps API for Business existante est-elle Google disponible ?	Tâches
   Licence existante disponible	Dans l' Propriétés système > Google Maps Forme de la propriété : Dans le champ google.maps.client , saisissez 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 de Google Maps API for Business. Un exemple de clé codée est vNIXE0xscrmjlyV-12Nj_BvUPaw=. Le Now Platform® nécessite cette clé pour récupérer des estimations précises du temps de conduite pour 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 Google site Web pour plus d’informations sur l’obtention d’une clé, à l’aide de l’API et les conditions d’utilisation pertinentes.
   Aucune licence disponible	Obtenir une Google clé API JavaScript pour Maps à partir de Google. Dans l' Propriétés système > Google Maps , saisissez la clé API dans le champ google.maps.key . La géolocalisation dans le Now Platform® utilise la clé API, que Google Maps utilise également pour la géolocalisation et la facturation des vues cartographiques. 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 entreprise 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 fournies avec le module d’extension.
   Les pages de carte définissent les données qui s’affichent sur la carte et l’apparence des liens. Pour obtenir un didacticiel sur la façon d’afficher tous les marqueurs liés à vos enregistrements, consultez le billet de blog Afficher les marqueurs de carte sur Google Maps sur leServiceNow Community.

   Propriété	Description
   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 l’API Maps pour les entreprises. 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 l’API Maps pour entreprise Cette touche active la fonction 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
   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 version actuelle Emplacement : Propriétés système > Google Maps
   google.maps.key	Google API Maps pour entreprise ou Google Maps Clé API JavaScript liée à l’URL du serveur. Cette clé autorise l’utilisation de développement de l’API Google Maps. 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 > Tout.
   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 carte [cmn_coordinate_refresh_config].
   4. S’il n’y a aucun champ à suivre lors 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 à laquelle les coordonnées sont récupérées pour la dernière fois est correctement renseignée dans la table Configuration de l’actualisation des coordonnées de carte [cmn_coordinate_refresh_config]. Consultez 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, 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 :

      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 de dictionnaire. Assurez-vous d’utiliser les codes pays ISO 3166-1. Par exemple, le code pays du Maroc est MA.
   3. Accédez à la Propriétés système > Google Maps.
   4. Cochez la case Oui pour 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 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.