Google Maps API einrichten

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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
    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 Systemeigenschaften > Google 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.
      2. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle.
      Hinweis:
      Siehe Leitfaden Für Die Ersten Schritte 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 Systemeigenschaften > Google 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.
      Um mehr zu erfahren GoogleOrdnet API für Geschäft und zu GoogleOrdnet 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 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 Blogbeitrag auf ServiceNow Community.
      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: Systemeigenschaften > Google Maps
      google.Maps.Client Client-ID für GoogleOrdnet 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 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: Systemeigenschaften > Google Maps
      google.Maps.Version Versionsnummer der aktuellen Installation von GoogleOrdnet API für das Geschäft zu.
      • Typ: Zeichenfolge
      • Standardwert: Aktuelle Versionsnummer
      • Standort: Systemeigenschaften > Google Maps
      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: Systemeigenschaften > Google Maps
      google.Maps.Breitengrad Startbreitengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition GoogleKarten.
      • Typ: Zeichenfolge
      • Standardwert: 36,008522
      • Standort: Systemeigenschaften > Google Maps
      google.Maps.Längengrad Startlängengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition GoogleKartenseiten.
      • Typ: Zeichenfolge
      • Standardwert: -95,221764
      • Standort: Systemeigenschaften > Google Maps
      google.Maps.max_items Maximale Anzahl von Elementen, die auf der Karte angezeigt werden sollen.
      • Typ: Ganzzahl
      • Standardwert: 500
      • Standort: Systemeigenschaften > Google Maps
      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: 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, 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.
      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 GoogleZuordnungen von ServiceNowFühren Sie diese Konfigurationen basierend auf Ihrer Region durch.
      1. Navigieren zu Anwenderadministration > Anwenderan.
      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 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 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.