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
Prozedur
-
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 - 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.
- In google.Maps.Client Feld,geben Sie die Client-ID für Ihre Organisation ein. Diese ID stammt aus Google Und beginnt mit
- 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 - Besorgen Sie sich 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 Abrechnungen der Kartenansicht.
- Füllen Sie die verbleibenden Werte im Formular aus.
- 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. - In Systemeigenschaften > Google Maps Eigenschaftsformular:
-
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
-
Führen Sie diese Konfigurationen aus:
- Navigieren zu Systemeigenschaften > Allean.
-
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. - Geben Sie die Tabellen an, in denen die Standortdetails in der Tabelle „Konfiguration der Kartenkoordinaten aktualisieren“ [cmn_Coordinate_refresh_config] gespeichert werden.
-
Wenn keine Felder zum Nachverfolgen vorhanden sind, wann die Koordinaten zuletzt in Ihren Tabellen abgerufen wurden:
- Erstellen Sie Coordinates_Retrieved_on Feld des Typs Datum/Uhrzeit In Ihren Tabellen.
- 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.
- Navigieren zu Systemdefinition > Geplante Aufgabenan.
- Öffnen Sie den Datensatz, Aktualisieren Sie die Informationen zum Längengrad des Breitengrads von Datensätzen .
- Aktivieren Sie die Checkbox Aktiv.
-
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.
- Wahlweise:
Um auf zuzugreifen Google Zuordnungen aus dem ServiceNow Führen Sie diese Konfigurationen basierend auf Ihrer Region durch.
- Navigieren zu Anwenderadministration > Anwenderan.
-
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 .
- Navigieren zu Systemeigenschaften > Google Mapsan.
- 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.
- Klicken Sie auf Speichern.