--- sourceDocument: Yokohama Now Plattformverwaltung sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/platform-administration Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Plattformverwaltung ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Google Maps API einrichten # Google Maps API einrichten {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer Sie aktivieren die Positionsbestimmungsfunktion mithilfe der entsprechenden Einträge aus einem GoogleOrdnet API für Geschäftslizenz oder zu GoogleOrdnet JavaScript-API-Schlüssel zu. ## Vorbereitungen Erforderliche Rolle: Administrator ## Warum und wann dieser Vorgang ausgeführt wird Sie können Karten mit Basis-JavaScript generieren, und sie sind flexibel genug, um selbst die kompliziertesten Abfragen anzuzeigen. Diese Karten verwenden Standard GoogleOrdnet API für Geschäft oder zu GoogleOrdnet JavaScript-API-Schlüsselzuordnungsfunktionen zu, einschließlich verschiedener Linktypen, Datensätzen in Ihrer Instanz. Die Verwendung dieser Funktion erfordert die Installation von GoogleZuordnungs-Plugin. Abbildung : 1. Zuordnungsseite ## Prozedur 1. GoogleKarten-APIs für Geschäftslizenzen sind ab nicht mehr verfügbar Google, Verwenden Sie also je nachdem, ob Sie über eine vorhandene Lizenz verfügen, eines der folgenden Verfahren. Hinweis: Sie müssen Ihren eigenen Google Maps-JavaScript-API-Schlüssel aus verwenden GoogleUnd keine verwenden Now Platform®Generierter Schlüssel. | Vorhanden GoogleKarten-API für Geschäftslizenz verfügbar? | Aufgaben | | Vorhandene Lizenz verfügbar | 1. In SystemeigenschaftenGoogle Maps Eigenschaftsformular: * In google.Maps.Client Feld,geben Sie die Client-ID für Ihre Organisation ein. Diese ID stammt aus GoogleUnd beginnt mit `gme: `, Z. B. `gme-mycompanyname `. * In google.maps.private.key Feld, geben Sie den privaten Schlüssel für ein GoogleOrdnet API für das Geschäft zu. Ein Beispiel für einen codierten Schlüssel ist `VNIXE0xscrmjlyV-12Nj_BvUPaw= `. Die Now Platform®Erfordert diesen Schlüssel, um genaue Fahrzeitschätzungen von abzurufen GoogleFür einige Positionsbestimmungsfunktionen. * Füllen Sie die verbleibenden Werte im Formular aus. {#set-up-google-maps-api__ul_wxf_1sj_smb} 2. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle. {#set-up-google-maps-api__ol_hqp_wnj_smb} Hinweis: Siehe [Leitfaden Für Die Ersten Schritte](https://developers.google.com/maps/documentation/javascript/tutorial)Auf GoogleWebsite mit Details zum Abrufen eines Schlüssels, zur Verwendung der API und relevanten Nutzungsbedingungen. | | Keine Lizenz verfügbar | 1. Erhalten Sie einen GoogleOrdnet JavaScript-API-Schlüssel von zu Google. 2. In SystemeigenschaftenGoogle Maps Eigenschaftsformular: Geben Sie den API-Schlüssel in ein google.maps.key Feld. Positionsbestimmung in Now Platform®Verwendet den API-Schlüssel, der GoogleKarten verwendet auch für Positionsbestimmung und Kartenansichtsabrechnungen. 3. Füllen Sie die verbleibenden Werte im Formular aus. 4. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle. {#set-up-google-maps-api__ol_qnd_vpj_smb} | |-|-| {#set-up-google-maps-api__choicetable_okq_vnj_smb} Um mehr zu erfahren GoogleOrdnet API für Geschäft und zu GoogleOrdnet JavaScript-API-Schlüssel zu, siehe . 2. Nachdem Sie die Konfiguration abgeschlossen und gespeichert haben, erstellen Sie Kartenseiten, oder verwenden Sie die Standardseiten, die im Plugin enthalten sind. Kartenseiten definieren, welche Daten auf der Karte angezeigt werden, und die Darstellung der Links. Ein Tutorial zum Anzeigen aller Markierungen, die mit Ihren Datensätzen verknüpft sind, finden Sie unter [Kartenmarkierungen in Google Maps anzeigen](https://community.servicenow.com/community?id=community_blog&sys_id=909ceae1dbd0dbc01dcaf3231f96192b)Blogbeitrag auf ServiceNow Community. {#set-up-google-maps-api__table_edd_4zf_vt__entry__2} | Eigenschaft | Beschreibung | |-|-| | google.maps.auto_close | Bei „wahr" wird automatisch ein Karteninformationsfenster geschlossen, bevor ein neues geöffnet wird. * Typ: Wahr/falsch * Standardwert: true * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_zb5_slr_bq} | | google.Maps.Client | Client-ID für GoogleOrdnet API für das Geschäft zu. * Typ: Zeichenfolge * Standardwert: gme-servicenow * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_pyj_ylr_bq} | | google.maps.private.key | Privater Schlüssel für GoogleOrdnet API für das Geschäft zu. Dieser Schlüssel aktiviert die Positionsbestimmungsfunktion, die Anwender im System mithilfe von Daten von ihren Mobilgeräten genau findet. * Typ: Zeichenfolge * Standardwert: Leer * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_j1k_zlr_bq} | | google.Maps.Version | Versionsnummer der aktuellen Installation von GoogleOrdnet API für das Geschäft zu. * Typ: Zeichenfolge * Standardwert: Aktuelle Versionsnummer * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_acs_zlr_bq} | | google.maps.key | GoogleOrdnet API für Geschäft oder zu GoogleOrdnet JavaScript-API-Schlüssel zu, der mit der URL des Servers verknüpft ist. Dieser Schlüssel autorisiert die Entwicklungsverwendung von GoogleOrdnet API zu. * Typ: Zeichenfolge * Standardwert: Leer * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_zsx_zlr_bq} | | google.Maps.Breitengrad | Startbreitengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition GoogleKarten. * Typ: Zeichenfolge * Standardwert: 36,008522 * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_qvc_1mr_bq} | | google.Maps.Längengrad | Startlängengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition GoogleKartenseiten. * Typ: Zeichenfolge * Standardwert: -95,221764 * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_pbp_1mr_bq} | | google.Maps.max_items | Maximale Anzahl von Elementen, die auf der Karte angezeigt werden sollen. * Typ: Ganzzahl * Standardwert: 500 * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_lgy_1mr_bq} | | google.Maps.table | Von der Zuordnung verwendete Tabelle. Die Tabelle benötigt die folgenden Felder: Name, Längengrad, Breitengrad. * Typ: Zeichenfolge * Standardwert: cmn_location * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_xyd_bmr_bq} | | google.Maps.Zoom | Startzoomstufe der Karte (1 ist die niedrigste) * Typ: Zeichenfolge * Standardwert: 4 * Standort: SystemeigenschaftenGoogle Maps {#set-up-google-maps-api__ul_tys_bmr_bq} | [ ] {#set-up-google-maps-api__table_edd_4zf_vt} 3. Führen Sie diese Konfigurationen aus: 1. Navigieren zu SystemeigenschaftenAllean. 2. Legen Sie Werte für diese Systemeigenschaften fest: {#set-up-google-maps-api__table_dww_kh2_r4b__entry__2} | Systemeigenschaft | Beschreibung | |-|-| | google.Maps.refresh.latlong.duration | Anzahl der Tage, nach denen die Standortdetails aktualisiert werden. Hinweis: Der Höchstwert ist 30. | | google.maps.refresh.latlong.record_count_per_table | Maximale Anzahl von Datensätzen in einer Tabelle, die mit der geplanten Aufgabe in einer Aktualisierung verarbeitet werden können. | [ ] {#set-up-google-maps-api__table_dww_kh2_r4b} 3. Geben Sie die Tabellen an, die die Standortdetails in der Tabelle „Konfiguration der Kartenkoordinaten-Aktualisierung" \[cmn_coordinate_refresh_config\] speichern. 4. Wenn keine Felder zum Nachverfolgen vorhanden sind, wann die Koordinaten zuletzt in Ihren Tabellen abgerufen wurden: 1. Erstellen Sie Coordinates_Retrieved_on Feld des Typs Datum/Uhrzeit In Ihren Tabellen. 2. Stellen Sie sicher, dass der Wert des Felds, das die Zeit nachverfolgt, zu der die Koordinaten zuletzt abgerufen wurden, in der Tabelle „Konfiguration der Aktualisierung der Kartenkoordinaten" \[cmn_coordinate_refresh_config\] korrekt ausgefüllt ist. Weitere Informationen finden Sie im Beispiel-Korrekturskript Aktualisieren Sie die Koordinaten im Feld Um Werte in zu aktualisieren Coordinates_Retrieved_on Feld. {#set-up-google-maps-api__ol_rt4_m32_r4b} 5. Navigieren zu SystemdefinitionGeplante Aufgabenan. 6. Öffnen Sie den Datensatz, Aktualisieren Sie die Informationen zum Längengrad des Breitengrads von Datensätzen . 7. Aktivieren Sie die Checkbox Aktiv. 8. Geben Sie die Häufigkeit an, mit der die Standortdetails aktualisiert werden sollen, indem Sie Häufigkeitsdetails in angeben Ausführen Und Wiederholungsintervall . Hinweis: Stellen Sie sicher, dass Sie die Standortdetails mindestens alle 30 Tage aktualisieren. {#set-up-google-maps-api__substeps_fqt_gh2_r4b} 4. **Wahlweise:** Um auf zuzugreifen GoogleZuordnungen von ServiceNowFühren Sie diese Konfigurationen basierend auf Ihrer Region durch. 1. Navigieren zu AnwenderadministrationAnwenderan. 2. Wählen Sie das relevante aus, und weisen Sie es zu Ländercode Für den erforderlichen Anwender. Hinweis: Wenn erforderlich Ländercode Ist nicht verfügbar, fügen Sie den Wörterbucheintrag hinzu. Stellen Sie sicher, dass Sie die ISO 3166-1-Ländercodes verwenden. Beispiel: Der Ländercode von Marokko ist MA . 3. Navigieren zu SystemeigenschaftenGoogle Mapsan. 4. Wählen Sie aus Ja Kontrollkästchen für Aktivieren Sie diese Eigenschaft nur, wenn Sie das Verhalten der Google Map basierend auf einer Region ändern möchten. Die Region wird aus dem Feldwert „Ländercode" des aktuellen Anwenders im Datensatz „sys_user" ausgefüllt. Der Ländercode-Wert im Datensatz „sys_user" muss den Erwartungen des Regionalcodes der Google Map entsprechen. Die meisten Unicode-Regionsbezeichner sind mit ISO 3166-1-Codes identisch, mit einigen bedeutenden Ausnahmen. Überprüfen Sie die Codes ordnungsgemäß, bevor Sie Änderungen vornehmen. 5. Klicken Sie auf Speichern. {#set-up-google-maps-api__substeps_xs5_vk5_kqb}