Google Maps API einrichten

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 Karten 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 JavaScript-API-Schlüsselzuordnungsfunktionen zu, einschließlich verschiedener Linktypen, Datensätzen in Ihrer Instanz. Die Verwendung dieser Funktion erfordert die Installation von Google Zuordnungs-Plugin.

Wichtig:

Ab Mai 2026 stellt Google die Verwendung von Client-ID für die Authentifizierung von Anforderungen bei Google Maps fest. Ab diesem Datum sind API-Schlüssel die einzige unterstützte Authentifizierungsmethode. Wenn Ihre Anwendung weiterhin Client-ID verwendet (z. B. über google.maps.method property), Google Maps-Anforderungen schlagen fehl. Weitere Informationen finden Sie unter Client-ID-Migrationsleitfaden .

Aktualisieren Sie Ihre Konfiguration, um sich nur mit einem API-Schlüssel zu authentifizieren (d. h. „SET“ google.maps.methodBis Schlüssel ). Weitere Informationen finden Sie in den Beschreibungen von google.maps.keyUnd google.maps.key.geocodingEigenschaften für weitere Informationen zur API-Schlüssel-basierten Authentifizierung.

Prozedur

1. Google Karten-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 Google Und keine verwenden ServiceNow AI Platform® Generierter Schlüssel.

   Vorhanden Google Karten-API für Geschäftslizenz verfügbar?	Aufgaben
   Vorhandene Lizenz verfügbar	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.client.key Feld, geben Sie den privaten Schlüssel für ein 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. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle. Wichtig: Die auf der Google Maps-Client-ID basierende Konfiguration ist veraltet. Die Client-ID-Authentifizierung wird ab Mai 2026 nicht unterstützt, und Konfigurationen, die darauf basieren, funktionieren nicht mehr.
   Keine Lizenz verfügbar	Erhalten Sie einen Google Ordnet JavaScript-API-Schlüssel von zu Google. 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 Kartenansichtsabrechnungen. Füllen Sie die verbleibenden Werte im Formular aus. Konfigurieren Sie Ihre Karten mithilfe der Eigenschaftsdefinitionen aus der Tabelle.

   Um mehr zu erfahren Google Ordnet API für Geschäft 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 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.method	Definiert, welche Authentifizierungsmethode für Google Maps verwendet werden soll. Typ: Zeichenfolge Standardwert: Schlüssel Standort: Systemeigenschaften > Google Maps
   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.Map_ID	Karten-ID für Google Maps, die für die cloudbasierte Kartenstile, Vektorzuordnungen und erweiterte Markierungen verwendet wird. Informationen zum Abrufen Ihrer Karten-ID finden Sie unter So erstellen Sie Karten-IDs . Typ: Zeichenfolge Standardwert: leer Standort: Systemeigenschaften > Google Maps
   google.maps.client.key	Privater Schlüssel für Google Ordnet 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 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 Ordnet API zu. Typ: Zeichenfolge Standardwert: leer Standort: Systemeigenschaften > Google Maps
   google.Maps.key.Geocoding	Google Maps-API für Business oder Google Maps-JavaScript-API-Schlüssel, der an die URL des Servers gebunden ist. Dieser Schlüssel wird für Geocoding-Anforderungen verwendet. Typ: Zeichenfolge Standardwert: leer Standort: Systemeigenschaften > Google Maps
   google.Maps.Breitengrad	Startbreitengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition Google Karten. Typ: Zeichenfolge Standardwert: 36,008522 Standort: Systemeigenschaften > Google Maps
   google.Maps.Längengrad	Startlängengrad der Karte. Dieser Wert bestimmt die in angezeigte Startposition Google Kartenseiten. 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 Google Zuordnungen von ServiceNow Fü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.