Google Maps API einrichten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Sie aktivieren die Positionsbestimmungsfunktion mithilfe der entsprechenden Einträge aus einer Google Maps API for Business-Lizenz oder einem Google Maps-JavaScript-API-Schlüssel.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können Zuordnungen mit einfachem JavaScript generieren. Sie sind flexibel genug, um selbst die kompliziertesten Abfragen anzuzeigen. Diese Karten verwenden standardmäßige Google Maps-API für Unternehmen oder Google Maps-JavaScript-API-Schlüsselzuordnungsfunktionen, einschließlich verschiedener Linktypen zu Datensätzen in Ihrer Instanz. Die Verwendung dieser Funktion erfordert die Installation des Plugins Google Maps.
    Abbildung : 1. Kartenseite
    Kartenseite

    Prozedur

    1. Google Maps-APIs für Geschäftslizenzen sind ab Googlenicht mehr verfügbar. Verwenden Sie daher je nachdem, ob eine Lizenz vorhanden ist, eines der folgenden Verfahren.
      Hinweis:
      Sie müssen Ihren eigenen Google Maps-JavaScript-API-Schlüssel von Google verwenden und dürfen keinen von Now Platform® generierten Schlüssel verwenden.
      Vorhandene Google Maps-API für Geschäftslizenz verfügbar?Aufgaben
      Vorhandene Lizenz verfügbar
      1. In der Systemeigenschaften > Google Maps Eigenschaftsformular:
        • Geben Sie im Feld google.maps.client die Client-ID für Ihre Organisation ein. Diese ID stammt aus Google und beginnt mit gme-, z. B. gme-mycompanyname.
        • Geben Sie im Feld google.maps.private.key den privaten Schlüssel für Google Maps API for Business ein. Ein Beispiel für einen codierten Schlüssel ist vNIXE0xscrmjlyV-12Nj_BvUPaw=. Now Platform® erfordert diesen Schlüssel, um genaue Fahrzeitschätzungen von Google für einige Positionsbestimmungsfunktionen abzurufen.
        • Füllen Sie die verbleibenden Werte im Formular aus.
      2. Konfigurieren Sie Ihre Zuordnungen mithilfe der Eigenschaftsdefinitionen aus der Tabelle.
      Hinweis:
      Weitere Informationen zum Erhalt eines Schlüssels, zur Verwendung der API und die entsprechenden Servicebedingungen finden Sie im Leitfaden für erste Schritte auf der Website Google.
      Keine Lizenz verfügbar
      1. Rufen Sie einen Google Maps-JavaScript-API-Schlüssel von Googleab.
      2. In der Systemeigenschaften > Google Maps Eigenschaftsformular, geben Sie den API-Schlüssel in das Feld google.maps.key ein.

        Die Positionsbestimmung in Now Platform® verwendet den API-Schlüssel, den Google Maps auch für die Positionsbestimmung und die Abrechnung von Kartenansichten verwendet.

      3. Füllen Sie die verbleibenden Werte im Formular aus.
      4. Konfigurieren Sie Ihre Zuordnungen mithilfe der Eigenschaftsdefinitionen aus der Tabelle.
      Weitere Informationen zu Google Maps API for Business und Google Maps JavaScript API Key finden Sie unter https://developers.google.com/maps/gmp-get-started.
    2. Nachdem Sie die Konfiguration abgeschlossen und gespeichert haben, erstellen Sie Kartenseiten, oder verwenden Sie die im Plugin enthaltenen Standardseiten.
      Kartenseiten definieren, welche Daten auf der Karte angezeigt werden und wie die Links aussehen. Ein Tutorial zum Anzeigen aller Markierungen, die mit Ihren Datensätzen verknüpft sind, finden Sie im Blog-Beitrag Kartenmarkierungen in Google Maps anzeigen auf der ServiceNow Community.
      Eigenschaft Beschreibung
      google.maps.auto_close Bei „true“ wird ein Karteninformationsfenster automatisch geschlossen, bevor ein neues geöffnet wird.
      • Typ: true/false
      • Standardwert: true
      • Standort: Systemeigenschaften > Google Maps
      google.maps.client Client-ID für Google Maps-API für Unternehmen.
      • Typ: Zeichenfolge
      • Standardwert: gme-servicenow
      • Standort: Systemeigenschaften > Google Maps
      google.maps.private.key Privater Schlüssel für Google Maps-API für Unternehmen. Dieser Schlüssel aktiviert die Positionsbestimmungsfunktion, die Benutzer im System mithilfe von Daten von ihren Mobilgeräten genau ortet.
      • Typ: Zeichenfolge
      • Standardwert: leer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.version Versionsnummer der aktuellen Installation von Google Maps API for Business.
      • Typ: Zeichenfolge
      • Standardwert: aktuelle Versionsnummer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.key Google Maps-API für Unternehmen oder Google Maps-JavaScript-API-Schlüssel, der an die URL des Servers gebunden ist. Dieser Schlüssel autorisiert die Entwicklungsverwendung der Google Maps-API.
      • Typ: Zeichenfolge
      • Standardwert: leer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.latitude Start-Breitengrad der Karte. Dieser Wert bestimmt die Startposition, die in Google Karten angezeigt wird.
      • Typ: Zeichenfolge
      • Standardwert: 36.008522
      • Standort: Systemeigenschaften > Google Maps
      google.maps.longitude Start-Längengrad der Karte. Dieser Wert bestimmt die Startposition, die auf Google Kartenseiten angezeigt wird.
      • 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 Anfangszoomstufe der Karte (1 ist die niedrigste Stufe)
      • Typ: Zeichenfolge
      • Standardwert: 4
      • Standort: Systemeigenschaften > Google Maps
    3. Führen Sie die folgenden Konfigurationen aus:
      1. Navigieren zu Systemeigenschaften > Alle.
      2. Legen Sie Werte für die folgenden Systemeigenschaften fest:
        Systemeigenschaft Beschreibung
        google.maps.refresh.latlong.duration Anzahl der Tage, nach denen die Standortdetails aktualisiert werden.
        Hinweis:
        Der maximale Wert beträgt 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, in denen die Standortdetails gespeichert werden, in der Tabelle „Konfiguration der Kartenkoordinaten-Aktualisierung“ [cmn_coordinate_refresh_config] an.
      4. Wenn keine Felder vorhanden sind, um nachzuverfolgen, wann die Koordinaten zuletzt in Ihren Tabellen abgerufen wurden:
        1. Erstellen Sie das Feld „ koordinaten_retrieved_on “ vom Typ 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 Kartenkoordinaten-Aktualisierung“ [cmn_coordinate_refresh_config] korrekt ausgefüllt ist. Informationen zum Aktualisieren der Werte im Feld „ koordinaten_retrieved_on “ finden Sie im Beispiel-Korrekturskript Koordinaten aktualisieren, die am Feld aktualisiert wurden.
      5. Navigieren zu Systemdefinition > Geplante Aufgaben.
      6. Öffnen Sie den Datensatz, Breitengrad-Längengrad-Informationen von Datensätzen aktualisieren.
      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 Ausführen und Wiederholungsintervall angeben.
        Hinweis:
        Stellen Sie sicher, dass Sie die Standortdetails mindestens alle 30 Tage aktualisieren.
    4. Wahlweise: Führen Sie die folgenden Konfigurationen aus, um basierend auf Ihrer Region über die Instanz ServiceNow auf Google Maps zuzugreifen.
      1. Navigieren zu Benutzeradministration > Benutzer.
      2. Wählen Sie den relevanten Ländercode für den erforderlichen Benutzer aus, und weisen Sie ihn zu.
        Hinweis:
        Wenn der erforderliche Ländercode nicht verfügbar ist, 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 lautet MA.
      3. Navigieren zu Systemeigenschaften > Google Maps.
      4. Aktivieren Sie das Kontrollkästchen Ja für . Aktivieren Sie diese Eigenschaft nur, wenn Sie das Verhalten der Google-Karte basierend auf einer Region ändern möchten. Die Region wird aus dem Feldwert „Ländercode“ des aktuellen Anwenders im sys_user-Datensatz ausgefüllt. Der Ländercodewert im sys_user-Datensatz muss mit den Erwartungen des Regionscodes von Google Maps übereinstimmen. Die meisten Unicode-Regionsbezeichner sind mit einigen nennenswerten Ausnahmen identisch mit ISO 3166-1-Codes. Überprüfen Sie die Codes ordnungsgemäß, bevor Sie Änderungen vornehmen.
      5. Klicken Sie auf Speichern.