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 les fonctionnalités de mappage standard Google de l’API Maps API for Business ou Google 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.

Figure 1. Page de carte

Procédure

1. Google Les API Maps pour les licences d’entreprise ne sont plus disponibles à partir de Google, par conséquent, selon que vous disposez d’une licence existante, utilisez l’une des procédures suivantes.
   Remarque :

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

   Licence Maps API for Business existante Google 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 commence Google par gme-, comme gme-mycompanyname. Dans le champ google.maps.private.key , saisissez la clé privée de Google l’API Maps pour entreprise. Un exemple de clé codée est vNIXE0xscrmjlyV-12Nj_BvUPaw=. Cette Now Platform® clé nécessite cette clé pour récupérer des estimations précises de temps de trajet 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 mise en route sur le site Web pour plus de détails sur l’obtention Google d’une clé, l’utilisation de l’API et les conditions d’utilisation pertinentes.
   Aucune licence disponible	Obtenir une Google clé API JavaScript Maps à 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 utilise Now Platform® 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 for Business et Google la Google clé API JavaScript Maps, reportez-vous à la section 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 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 l’article de blog Afficher les marqueurs de carte sur Google Maps sur le .ServiceNow 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 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 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
   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 les entreprises ou Google JavaScript Maps API Clé liée à l’URL du serveur. Cette clé autorise l’utilisation de l’API Google Maps au 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 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 > 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 la carte [cmn_coordinate_refresh_config].
   4. S’il n’y a pas de champs pour 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 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 Mettre à jour les coordonnées mises à jour 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 du 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 compatible avec les 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.

Tâches associées

• Créer une page de carte
• Créer un module de page de carte
• Créer une page de carte avancée
• Définir le périmètre de l’application de carte
• Créer un module de page de carte pour smartphone

Référence associée

• Scripting pour les pages de carte