--- sourceDocument: Interface utilisateur de la Now Platform Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/platform-user-interface Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Interface utilisateur de la Now Platform Xanadu ft:clusterId : - platux bundleId : - platux workflow : - Platform --- # Configurer l'API Google Maps # Configurer l'API Google Maps {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture 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 | 1. Dans l' Propriétés systèmeGoogle 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. {#set-up-google-maps-api__ul_wxf_1sj_smb} 2. Configurez vos cartes à l'aide des définitions de propriétés de la table. {#set-up-google-maps-api__ol_hqp_wnj_smb} Remarque : Consultez le [Guide de démarrage](https://developers.google.com/maps/documentation/javascript/tutorial) 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 | 1. Obtenir une Google clé API JavaScript pour Maps à partir de Google. 2. Dans l' Propriétés systèmeGoogle 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. 3. Renseignez les valeurs restantes sur le formulaire. 4. Configurez vos cartes à l'aide des définitions de propriétés de la table. {#set-up-google-maps-api__ol_qnd_vpj_smb} | |-|-| {#set-up-google-maps-api__choicetable_okq_vnj_smb} Pour en savoir plus sur l'API Maps pour entreprise et Google la Google clé API JavaScript Maps, consultez . 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 le](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b)ServiceNow Community. {#set-up-google-maps-api__table_edd_4zf_vt__entry__2} | 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èmeGoogle Maps {#set-up-google-maps-api__ul_zb5_slr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_pyj_ylr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_j1k_zlr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_acs_zlr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_zsx_zlr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_qvc_1mr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_pbp_1mr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_lgy_1mr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_xyd_bmr_bq} | | 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èmeGoogle Maps {#set-up-google-maps-api__ul_tys_bmr_bq} | [ ] {#set-up-google-maps-api__table_edd_4zf_vt} 3. Effectuez les configurations suivantes : 1. Accédez à la Propriétés systèmeTout. 2. Définissez les valeurs de ces propriétés système : {#set-up-google-maps-api__table_dww_kh2_r4b__entry__2} | 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. | [ ] {#set-up-google-maps-api__table_dww_kh2_r4b} 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 . {#set-up-google-maps-api__ol_rt4_m32_r4b} 5. Accédez à la Définition du systèmeTravaux 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. {#set-up-google-maps-api__substeps_fqt_gh2_r4b} 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 utilisateursUtilisateurs. 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èmeGoogle 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. {#set-up-google-maps-api__substeps_xs5_vk5_kqb} **Tâches associées** * [Créer une page de carte](https://servicenow-prod.fluidtopics.net/tIAyD5i7bwn3sFkGJQl_jw "Votre ServiceNow instance fournit plusieurs pages de carte par défaut. Vous pouvez également créer des pages de carte personnalisées avec les exemples de script décrits sur cette page.") * [Créer un module de page de carte](https://servicenow-prod.fluidtopics.net/4oB2JwOmJZw_JetsAypIWA "Vous pouvez créer un module d’application pour les utilisateurs d’ordinateurs de bureau ou de smartphones afin d’afficher une Google page de carte.") * [Créer une page de carte avancée](https://servicenow-prod.fluidtopics.net/SxdCdSD6O~J44fmwcCxXSA "Utilisez la configuration avancée pour configurer des pages de carte sans script.") * [Définir le périmètre de l'application de carte](https://servicenow-prod.fluidtopics.net/acE8uC3VrY_8PXJThN3yAA "Activez le périmètre de l’application Carte pour spécifier quelle application peut modifier votre configuration de page de carte.") * [Créer un module de page de carte pour smartphone](https://servicenow-prod.fluidtopics.net/90eAvv0mIPciVuG8fP9BXg "Vous pouvez créer un module personnalisé pour smartphone qui est directement lié à une page de carte.") **Référence associée** * [Scripting pour les pages de carte](https://servicenow-prod.fluidtopics.net/h_feKTKQUgcSL18CfvU1vQ "Le champ Script du formulaire Page de carte permet l’utilisation d’attributs ou de code personnalisé pour définir les caractéristiques de la carte, telles que l’apparence du marqueur, les informations d’affichage, etc.")