Google Maps API einrichten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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, und sie sind so flexibel, dass selbst die komplexesten Abfragen angezeigt werden können. Diese Karten verwenden standardmäßige Zuordnungsfunktionen für Google Maps API for Business oder Google Maps JavaScript API Key, einschließlich verschiedener Linktypen zu Datensätzen in Ihrer Instanz. Zur Verwendung dieser Funktion muss das Plugin Google „ Maps installiert werden.
    Abbildung : 1. Kartenseite
    Kartenseite

    Prozedur

    1. Google Maps-APIs für Business-Lizenzen sind ab Googlenicht mehr verfügbar. Verwenden Sie daher, je nachdem, ob Sie eine vorhandene Lizenz haben, eines der folgenden Verfahren.
      Hinweis:
      Sie müssen Ihren eigenen Google Maps JavaScript API-Schlüssel von Google und keinen von Now Platform® generierten Schlüssel verwenden.
      Vorhandene Google Maps API for Business-Lizenz verfügbar?Aufgaben
      Vorhandene Lizenz verfügbar
      1. Im Systemeigenschaften > Google Maps Eigenschaftsformular:
        • Geben Sie im Feld google.maps.client die Client-ID für Ihre Organisation ein. Diese ID stammt aus dem 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® benötigt diesen Schlüssel, um genaue Schätzungen der Fahrzeit von Google für einige Positionsbestimmungsfunktionen abzurufen.
        • Füllen Sie die verbleibenden Werte im Formular aus.
      2. Konfigurieren Sie Ihre Zuordnungen mit den Eigenschaftsdefinitionen aus der Tabelle.
      Hinweis:
      Weitere Informationen zum Erhalt eines Schlüssels und zur Verwendung der API sowie entsprechende Nutzungsbedingungen finden Sie im Handbuch „Erste Schritte“ auf der Website Google.
      Keine Lizenz verfügbar
      1. Rufen Sie einen Google JavaScript-API-Schlüssel für Zuordnungen von Googleab.
      2. Im Systemeigenschaften > Google Maps Geben Sie im Eigenschaftsformular 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 Abrechnung der Positionsbestimmung und der Kartenansicht verwendet.

      3. Füllen Sie die verbleibenden Werte im Formular aus.
      4. Konfigurieren Sie Ihre Zuordnungen mit den Eigenschaftsdefinitionen aus der Tabelle.
      Weitere Informationen zur Google Maps-API für Unternehmen und zum Google Maps-JavaScript-API-Schlüssel finden Sie unter https://developers.google.com/maps/gmp-get-started.
    2. Nachdem Sie die Konfiguration abgeschlossen und gespeichert haben, erstellen Sie Zuordnungsseiten, oder verwenden Sie die im Plugin enthaltenen Standardseiten.
      Kartenseiten definieren, welche Daten auf der Karte angezeigt werden und wie die Links dargestellt werden. Ein Tutorial zum Anzeigen aller Markierungen, die mit Ihren Datensätzen verknüpft sind, finden Sie im Blog-Beitrag Kartenmarker in Google Maps anzeigen auf der ServiceNow Community.
      Eigenschaft Beschreibung
      google.maps.auto_close Bei „wahr“ wird ein Karteninformationsfenster automatisch geschlossen, bevor ein neues geöffnet wird.
      • Typ: true/false
      • Standardwert: wahr
      • Standort: Systemeigenschaften > Google Maps
      google.maps.client Client-ID für Google Maps API for Business.
      • Typ: Zeichenfolge
      • Standardwert: gme-servicenow
      • Standort: Systemeigenschaften > Google Maps
      google.maps.private.key Privater Schlüssel für Google Maps API for Business. Dieser Schlüssel aktiviert die Positionsbestimmungsfunktion, die Benutzer im System anhand 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 Business oder Google Maps-JavaScript-API-Schlüssel, der an die URL des Servers gebunden ist. Dieser Schlüssel autorisiert die Verwendung der Google Maps-API für die Entwicklung.
      • Typ: Zeichenfolge
      • Standardwert: leer
      • Standort: Systemeigenschaften > Google Maps
      google.maps.latitude Start-Breitengrad der Karte. Dieser Wert bestimmt die in Google Karten angezeigte Startposition.
      • Typ: Zeichenfolge
      • Standardwert: 36.008522
      • Standort: Systemeigenschaften > Google Maps
      google.maps.longitude Start-Längengrad der Karte. Dieser Wert bestimmt die Startposition, die auf den Seiten mit Karten Google 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 der niedrigste Wert)
      • Typ: Zeichenfolge
      • Standardwert: 4
      • Standort: Systemeigenschaften > Google Maps
    3. Führen Sie diese Konfigurationen durch:
      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 der Datensätze 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 Kartenkoordinatenaktualisierung“ [cmn_coordinate_refresh_config] gespeichert werden.
      4. Wenn es keine Felder gibt, um nachzuverfolgen, wann die Koordinaten zuletzt in Ihren Tabellen abgerufen wurden:
        1. Erstellen Sie in Ihren Tabellen das Feld „ ordinates_retrieved_on “ vom Typ „ Datum/Uhrzeit “.
        2. Stellen Sie sicher, dass der Wert des Felds, das die Zeit nachverfolgt, wann die Koordinaten zuletzt abgerufen wurden, in der Tabelle „Konfiguration der Kartenkoordinatenaktualisierung“ [cmn_coordinate_refresh_config] ordnungsgemäß ausgefüllt ist. Informationen zum Aktualisieren von Werten im Feld „ koordinaten_retrieved_on “ finden Sie im Beispiel-Korrekturskript für das Feld „Koordinaten aktualisieren, das aktualisiert wird“.
      5. Navigieren zu Systemdefinition > Geplante Aufgabenan.
      6. Öffnen Sie den Datensatz, Aktualisieren Sie die Breitengrad-/Längengrad-Informationen 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 unter Ausführungs- und Wiederholungsintervall angeben.
        Hinweis:
        Stellen Sie sicher, dass Sie die Standortdetails mindestens alle 30 Tage aktualisieren.
    4. Wahlweise: Um von der Instanz ServiceNow basierend auf Ihrer Region auf die Karten [ Google zuzugreifen, führen Sie die folgenden Konfigurationen durch.
      1. Navigieren zu Anwenderadministration > Anwenderan.
      2. Wählen Sie den relevanten Ländercode für den gewünschten Anwender 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. Der Ländercode von Frankreich lautet beispielsweise MA.
      3. Navigieren zu Systemeigenschaften > Google Mapsan.
      4. Aktivieren Sie das Kontrollkästchen Ja für . Aktivieren Sie diese Eigenschaft nur, wenn Sie das Verhalten von Google Maps basierend auf einer Region ändern möchten. Die Region wird anhand des Feldwerts „Ländercode“ des aktuellen Anwenders im Datensatz „sys_user“ ausgefüllt. Der Ländercodewert im Datensatz „sys_user“ muss den Erwartungen an den Regionscode von Google Map entsprechen. Die meisten Unicode-Regionsbezeichner sind bis auf einige nennenswerte Ausnahmen mit ISO 3166-1-Codes identisch. Überprüfen Sie die Codes ordnungsgemäß, bevor Sie Änderungen vornehmen.
      5. Klicken Sie auf Speichern.