Google Maps API einrichten

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer
  • Sie aktivieren die Positionsbestimmungsfunktion mithilfe der entsprechenden Einträge aus einem Google Ordnet API für Geschäftslizenz oder zu Google Ordnet JavaScript-API-Schlüssel zu.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können Zuordnungen mit Basis-JavaScript generieren, und sie sind flexibel genug, um selbst die kompliziertesten Abfragen anzuzeigen. Diese Karten verwenden Standard Google Ordnet API für Geschäft oder zu Google Ordnet die Schlüsselzuordnungsfunktionen der JavaScript-API zu, einschließlich verschiedener Linktypen, Datensätzen in Ihrer Instanz. Die Verwendung dieser Funktion erfordert die Installation von Google Zuordnungen-Plugin.
    Abbildung : 1. Kartenseite
    Kartenseite

    Prozedur

    1. Google Zuordnungen-APIs für Geschäftslizenzen sind ab nicht mehr verfügbar Google, Je nachdem, ob eine Lizenz vorhanden ist, verwenden Sie eines der folgenden Verfahren.
      Hinweis:
      Sie müssen Ihren eigenen Google Maps JavaScript API-Schlüssel aus verwenden Google Und verwenden Sie keine ServiceNow AI Platform® Generierter Schlüssel.
      Vorhanden Google Karten-API für Business-Lizenz verfügbar?Aufgaben
      Vorhandene Lizenz verfügbar
      1. In Systemeigenschaften > Google Maps Eigenschaftsformular:
        • In google.Maps.Client Feld,geben Sie die Client-ID für Ihre Organisation ein. Diese ID stammt aus Google Und beginnt mit gme: , Z. B. gme-mycompanyname .
        • In google.maps.private.key Feld den privaten Schlüssel für eingeben Google Ordnet API für das Geschäft zu. Ein Beispiel für einen codierten Schlüssel ist VNIXE0xscrmjlyV-12Nj_BvUPaw= . Die ServiceNow AI Platform® Erfordert diesen Schlüssel, um genaue Fahrzeitschätzungen von abzurufen Google Für einige Positionsbestimmungsfunktionen.
        • Füllen Sie die verbleibenden Werte im Formular aus.
      2. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle.
      Hinweis:
      Siehe Leitfaden Für Die Ersten Schritte Auf der Google Website mit Details zum Abrufen eines Schlüssels, zur Verwendung der API und zu relevanten Nutzungsbedingungen.
      Keine Lizenz verfügbar
      1. Besorgen Sie sich einen Google Ordnet JavaScript-API-Schlüssel von zu Google.
      2. In Systemeigenschaften > Google Maps Eigenschaftsformular: Geben Sie den API-Schlüssel in ein google.maps.key Feld.

        Positionsbestimmung in ServiceNow AI Platform® Verwendet den API-Schlüssel, der Google Karten verwendet auch für Positionsbestimmung und Abrechnungen der Kartenansicht.

      3. Füllen Sie die verbleibenden Werte im Formular aus.
      4. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle.
      Um mehr über zu erfahren Google Ordnet API für Unternehmen und zu Google Ordnet JavaScript-API-Schlüssel zu, siehe https://developers.google.com/maps/gmp-get-started.
    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 wie die Links angezeigt werden. Ein Tutorial zum Anzeigen aller Markierungen, die mit Ihren Datensätzen verknüpft sind, finden Sie unter Kartenmarkierungen in Google Maps anzeigen Blogbeitrag auf der ServiceNow Community.
      Eigenschaft Beschreibung
      google.maps.auto_close Bei „wahr“ wird automatisch ein Karteninformationsfenster geschlossen, bevor ein neues geöffnet wird.
      • Typ: true/false
      • Standardwert: wahr
      • Standort: Systemeigenschaften > Google Maps
      google.maps.client Client-ID für Google Ordnet API für das Geschäft zu.
      • Typ: Zeichenfolge
      • Standardwert: gme-servicenow
      • Standort: Systemeigenschaften > Google Maps
      google.maps.private.key Privater Schlüssel für Google Ordnet API für das Geschäft zu. Dieser Schlüssel aktiviert die Positionsbestimmungsfunktion, die Anwender mithilfe von Daten von ihren Mobilgeräten genau im System findet.
      • Typ: Zeichenfolge
      • Standardwert: leer
      • Standort: Systemeigenschaften > Google Maps
      google.Maps.Version Versionsnummer der aktuellen Installation von Google Ordnet API für das Geschäft zu.
      • Typ: Zeichenfolge
      • Standardwert: Aktuelle Versionsnummer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.key Google Ordnet API für Geschäft oder zu Google Ordnet JavaScript-API-Schlüssel zu, der mit der URL des Servers verknüpft ist. Dieser Schlüssel autorisiert die Entwicklungsverwendung von Google Zuordnungs-API.
      • Typ: Zeichenfolge
      • Standardwert: leer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.latitude Start-Breitengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition Google Zuordnungen.
      • Typ: Zeichenfolge
      • Standardwert: 36.008522
      • Standort: Systemeigenschaften > Google Maps
      google.maps.longitude Start-Längengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition Google Zuordnungsseiten.
      • Typ: Zeichenfolge
      • Standardwert: -95.221764
      • Standort: Systemeigenschaften > Google Maps
      google.maps.max_items Maximale Anzahl an Elementen, die auf der Karte angezeigt werden.
      • Typ: Ganzzahl
      • Standardwert: 500
      • Standort: Systemeigenschaften > Google Maps
      google.maps.tabelle Tabelle, die von der Karte verwendet wird. Die Tabelle benötigt die folgenden Felder: Name, Längengrad, Breitengrad.
      • Typ: Zeichenfolge
      • Standardwert: cmn_location
      • Standort: Systemeigenschaften > Google Maps
      google.maps.zoom Startzoomstufe der Karte (1 ist die niedrigste)
      • Typ: Zeichenfolge
      • Standardwert: 4
      • Standort: Systemeigenschaften > Google Maps
    3. Führen Sie diese Konfigurationen aus:
      1. Navigieren zu Systemeigenschaften > Allean.
      2. Legen Sie Werte für diese Systemeigenschaften fest:
        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.
      3. Geben Sie die Tabellen an, in denen die Standortdetails in der Tabelle „Konfiguration der Kartenkoordinaten aktualisieren“ [cmn_Coordinate_refresh_config] gespeichert werden.
      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 „Aktualisierungskonfiguration für Kartenkoordinaten“ [cmn_Coordinate_refresh_config] korrekt ausgefüllt ist. Weitere Informationen finden Sie im Beispiel-Korrekturskript Aktualisieren Sie Koordinaten, die im Feld aktualisiert wurden Um Werte in zu aktualisieren Coordinates_Retrieved_on Feld.
      5. Navigieren zu Systemdefinition > Geplante 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.
    4. Wahlweise: Um auf zuzugreifen Google Zuordnungen aus dem ServiceNow Führen Sie diese Konfigurationen basierend auf Ihrer Region durch.
      1. Navigieren zu Anwenderadministration > Anwenderan.
      2. Wählen Sie das entsprechende 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. Beispielsweise lautet der Ländercode von Marokko MA .
      3. Navigieren zu Systemeigenschaften > Google 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 mit den Erwartungen des Regionalcodes von Google Map übereinstimmen. Die meisten Unicode-Regionsbezeichner sind mit ISO 3166-1-Codes identisch, mit einigen beachtlichen Ausnahmen. Überprüfen Sie die Codes ordnungsgemäß, bevor Sie Änderungen vornehmen.
      5. Klicken Sie auf Speichern.