Google Maps
Geocodierung, Routenplanung, Orte und Entfernungsberechnungen
Google Maps ist eine umfassende Plattform, die eine Vielzahl von APIs für Kartierung, Geocodierung, Routenplanung, Orte, Umweltdaten und mehr bietet. Über Sim können Ihre Agenten wichtige Google Maps Platform APIs nutzen, um eine Vielzahl standortbasierter Workflows zu automatisieren.
Die folgenden Google Maps APIs sind in dieser Integration enthalten:
- Geocoding API: Wandelt Adressen in Breiten- und Längengrade um und führt Reverse-Geocodierung durch.
- Directions API: Berechnet Routen und Wegbeschreibungen für Auto, Fußgänger, Fahrrad oder öffentliche Verkehrsmittel zwischen Standorten.
- Distance Matrix API: Berechnet Reiseentfernungen und -zeiten für mehrere Kombinationen von Start- und Zielorten.
- Places API: Sucht nach Orten (Unternehmen, Sehenswürdigkeiten, Einrichtungen) nach Name, Typ oder Nähe.
- Place Details API: Ruft detaillierte Informationen für einen bestimmten Ort ab, wie Adresse, Bewertungen, Öffnungszeiten und Kontaktinformationen.
- Elevation API: Ermittelt Höhendaten (Höhe über dem Meeresspiegel) für beliebige Standorte weltweit.
- Time Zone API: Ruft Zeitzoneninformationen für jeden geografischen Standort ab.
- Air Quality API: Ruft Echtzeit-Luftqualitätsdaten für bestimmte Koordinaten ab.
Mit diesen APIs können Ihre Sim-Agenten die Standortsuche und -anreicherung automatisieren, optimale Routen und Lieferungen planen, Zeiten und Entfernungen schätzen, Ortsdaten analysieren, Datensätze mit geografischem Kontext anreichern, Umweltbedingungen abrufen und mehr – alles ohne manuelle Arbeit oder externe Tools.
Wenn Sie Funktionen benötigen, die über das hier Aufgeführte hinausgehen, oder Unterstützung für zusätzliche Google Maps APIs anfordern möchten, lassen Sie es uns wissen!
Integrieren Sie Google Maps Platform APIs in Ihren Workflow. Unterstützt Geocodierung von Adressen zu Koordinaten, Reverse-Geocodierung, Abrufen von Wegbeschreibungen zwischen Standorten, Berechnung von Distanzmatrizen, Suche nach Orten, Abrufen von Ortsdetails, Höhendaten und Zeitzoneninformationen.
Aktuelle Luftqualitätsdaten für einen Standort abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel mit aktivierter Air Quality API |
lat | number | Ja | Breitengradkoordinate |
lng | number | Ja | Längengradkoordinate |
languageCode | string | Nein | Sprachcode für die Antwort (z. B. "en", "es") |
| Parameter | Typ | Beschreibung |
|---|
dateTime | string | Zeitstempel der Luftqualitätsdaten |
regionCode | string | Regionscode für den Standort |
indexes | array | Array von Luftqualitätsindizes |
↳ code | string | Indexcode (z. B. "uaqi", "usa_epa") |
↳ displayName | string | Anzeigename des Index |
↳ aqi | number | Luftqualitätsindexwert |
↳ aqiDisplay | string | Formatierte AQI-Anzeigezeichenfolge |
↳ color | object | RGB-Farbe für die AQI-Stufe |
↳ category | string | Kategoriebeschreibung (z. B. "Gut", "Mäßig") |
↳ dominantPollutant | string | Der dominierende Schadstoff |
pollutants | array | Array von Schadstoffkonzentrationen |
↳ code | string | Schadstoffcode (z. B. "pm25", "o3") |
↳ displayName | string | Anzeigename |
↳ fullName | string | Vollständiger Schadstoffname |
↳ concentration | object | Konzentrationsinformationen |
↳ value | number | Konzentrationswert |
↳ units | string | Einheiten (z. B. "PARTS_PER_BILLION") |
↳ additionalInfo | object | Zusätzliche Informationen über Quellen und Auswirkungen |
healthRecommendations | object | Gesundheitsempfehlungen für verschiedene Bevölkerungsgruppen |
Wegbeschreibung und Routeninformationen zwischen zwei Standorten abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
origin | string | Ja | Startort (Adresse oder lat,lng) |
destination | string | Ja | Zielort (Adresse oder lat,lng) |
mode | string | Nein | Reisemodus: driving, walking, bicycling oder transit |
avoid | string | Nein | Zu vermeidende Merkmale: tolls, highways oder ferries |
waypoints | json | Nein | Array von Zwischenwegpunkten |
units | string | Nein | Einheitensystem: metric oder imperial |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
| Parameter | Typ | Beschreibung |
|---|
routes | array | Alle verfügbaren Routen |
↳ summary | string | Routenzusammenfassung (Hauptstraßennamen) |
↳ legs | array | Routenabschnitte (Segmente zwischen Wegpunkten) |
↳ overviewPolyline | string | Kodierte Polylinie für die gesamte Route |
↳ warnings | array | Routenwarnungen |
↳ waypointOrder | array | Optimierte Wegpunktreihenfolge (falls angefordert) |
distanceText | string | Gesamtentfernung als lesbarer Text (z. B. „5,2 km") |
distanceMeters | number | Gesamtentfernung in Metern |
durationText | string | Gesamtdauer als lesbarer Text (z. B. „15 Min.") |
durationSeconds | number | Gesamtdauer in Sekunden |
startAddress | string | Aufgelöste Startadresse |
endAddress | string | Aufgelöste Zieladresse |
steps | array | Schritt-für-Schritt-Navigationsanweisungen |
↳ instruction | string | Navigationsanweisung (HTML entfernt) |
↳ distanceText | string | Schrittentfernung als Text |
↳ distanceMeters | number | Schrittentfernung in Metern |
↳ durationText | string | Schrittdauer als Text |
↳ durationSeconds | number | Schrittdauer in Sekunden |
↳ startLocation | object | Startkoordinaten des Schritts |
↳ endLocation | object | Endkoordinaten des Schritts |
↳ travelMode | string | Reisemodus für diesen Schritt |
↳ maneuver | string | Manövertyp (turn-left usw.) |
polyline | string | Kodierte Polylinie für die Hauptroute |
Berechnung von Reiseentfernung und -zeit zwischen mehreren Start- und Zielorten
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
origin | string | Ja | Startort (Adresse oder lat,lng) |
destinations | json | Ja | Array von Zielorten |
mode | string | Nein | Reisemodus: driving, walking, bicycling oder transit |
avoid | string | Nein | Zu vermeidende Merkmale: tolls, highways oder ferries |
units | string | Nein | Einheitensystem: metric oder imperial |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
| Parameter | Typ | Beschreibung |
|---|
originAddresses | array | Aufgelöste Startadressen |
destinationAddresses | array | Aufgelöste Zieladressen |
rows | array | Distanzmatrix-Zeilen (eine pro Startort) |
↳ elements | array | Elemente (eines pro Zielort) |
↳ distanceText | string | Entfernung als Text (z. B. "5,2 km") |
↳ distanceMeters | number | Entfernung in Metern |
↳ durationText | string | Dauer als Text (z. B. "15 Min.") |
↳ durationSeconds | number | Dauer in Sekunden |
↳ durationInTrafficText | string | Dauer im Verkehr als Text |
↳ durationInTrafficSeconds | number | Dauer im Verkehr in Sekunden |
↳ status | string | Elementstatus (OK, NOT_FOUND, ZERO_RESULTS) |
Höhendaten für einen Standort abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
lat | number | Ja | Breitengradkoordinate |
lng | number | Ja | Längengradkoordinate |
| Parameter | Typ | Beschreibung |
|---|
elevation | number | Höhe in Metern über dem Meeresspiegel (negativ für darunter) |
lat | number | Breitengrad der Höhenmessung |
lng | number | Längengrad der Höhenmessung |
resolution | number | Maximale Entfernung zwischen Datenpunkten (Meter), aus denen die Höhe interpoliert wurde |
Eine Adresse in geografische Koordinaten (Breiten- und Längengrad) umwandeln
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
address | string | Ja | Die zu geokodierende Adresse |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
region | string | Nein | Regionspräferenz als ccTLD-Code (z. B. us, uk) |
| Parameter | Typ | Beschreibung |
|---|
formattedAddress | string | Die formatierte Adresszeichenfolge |
lat | number | Breitengradkoordinate |
lng | number | Längengradkoordinate |
location | json | Standortobjekt mit lat und lng |
placeId | string | Google Place ID für diesen Standort |
addressComponents | array | Detaillierte Adresskomponenten |
↳ longName | string | Vollständiger Name der Komponente |
↳ shortName | string | Abgekürzter Name |
↳ types | array | Komponententypen |
locationType | string | Standortgenauigkeitstyp (ROOFTOP, RANGE_INTERPOLATED, etc.) |
Geolokalisierung eines Geräts mithilfe von WLAN-Zugangspunkten, Mobilfunkmasten oder IP-Adresse
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel mit aktivierter Geolocation API |
homeMobileCountryCode | number | Nein | Heimat-Mobilfunkländercode (MCC) |
homeMobileNetworkCode | number | Nein | Heimat-Mobilfunknetzcode (MNC) |
radioType | string | Nein | Funktyp: lte, gsm, cdma, wcdma oder nr |
carrier | string | Nein | Name des Mobilfunkanbieters |
considerIp | boolean | Nein | Ob IP-Adresse für Geolokalisierung verwendet werden soll (Standard: true) |
cellTowers | array | Nein | Array von Mobilfunkmast-Objekten mit cellId, locationAreaCode, mobileCountryCode, mobileNetworkCode |
wifiAccessPoints | array | Nein | Array von WLAN-Zugangspunkt-Objekten mit macAddress (erforderlich), signalStrength usw. |
| Parameter | Typ | Beschreibung |
|---|
lat | number | Breitengrad-Koordinate |
lng | number | Längengrad-Koordinate |
accuracy | number | Genauigkeitsradius in Metern |
Detaillierte Informationen über einen bestimmten Ort abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
placeId | string | Ja | Google Place ID |
fields | string | Nein | Kommagetrennte Liste der zurückzugebenden Felder |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
| Parameter | Typ | Beschreibung |
|---|
placeId | string | Google Place ID |
name | string | Name des Ortes |
formattedAddress | string | Formatierte Straßenadresse |
lat | number | Breitengrad-Koordinate |
lng | number | Längengrad-Koordinate |
types | array | Ortstypen (z. B. Restaurant, Café) |
rating | number | Durchschnittliche Bewertung (1,0 bis 5,0) |
userRatingsTotal | number | Gesamtanzahl der Nutzerbewertungen |
priceLevel | number | Preisniveau (0=Kostenlos, 1=Günstig, 2=Moderat, 3=Teuer, 4=Sehr teuer) |
website | string | Website-URL des Ortes |
phoneNumber | string | Lokal formatierte Telefonnummer |
internationalPhoneNumber | string | International formatierte Telefonnummer |
openNow | boolean | Ob der Ort derzeit geöffnet ist |
weekdayText | array | Öffnungszeiten formatiert nach Wochentag |
reviews | array | Nutzerbewertungen (bis zu 5 relevanteste) |
↳ authorName | string | Name des Bewerters |
↳ authorUrl | string | Profil-URL des Bewerters |
↳ profilePhotoUrl | string | Foto-URL des Bewerters |
↳ rating | number | Vergebene Bewertung (1-5) |
↳ text | string | Bewertungstext |
↳ time | number | Zeitstempel der Bewertung (Unix-Epoche) |
↳ relativeTimeDescription | string | Relative Zeit (z. B. „vor einem Monat") |
photos | array | Fotos des Ortes |
↳ photoReference | string | Foto-Referenz für Place Photos API |
↳ height | number | Fotohöhe in Pixeln |
↳ width | number | Fotobreite in Pixeln |
↳ htmlAttributions | array | Erforderliche Quellenangaben |
url | string | Google Maps-URL für den Ort |
utcOffset | number | UTC-Offset in Minuten |
vicinity | string | Vereinfachte Adresse (Stadtteil/Straße) |
businessStatus | string | Geschäftsstatus (OPERATIONAL, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY) |
Orte mithilfe einer Textabfrage suchen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
query | string | Ja | Suchabfrage (z. B. "Restaurants am Times Square") |
location | json | Nein | Standort zur Gewichtung der Ergebnisse ({lat, lng}) |
radius | number | Nein | Suchradius in Metern |
type | string | Nein | Ortstyp-Filter (z. B. restaurant, cafe, hotel) |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
region | string | Nein | Regionsgewichtung als ccTLD-Code (z. B. us, uk) |
| Parameter | Typ | Beschreibung |
|---|
places | array | Liste der gefundenen Orte |
↳ placeId | string | Google Place ID |
↳ name | string | Ortsname |
↳ formattedAddress | string | Formatierte Adresse |
↳ lat | number | Breitengrad |
↳ lng | number | Längengrad |
↳ types | array | Ortstypen |
↳ rating | number | Durchschnittliche Bewertung (1-5) |
↳ userRatingsTotal | number | Anzahl der Bewertungen |
↳ priceLevel | number | Preisniveau (0-4) |
↳ openNow | boolean | Ob derzeit geöffnet |
↳ photoReference | string | Fotoreferenz für Photos API |
↳ businessStatus | string | Geschäftsstatus |
nextPageToken | string | Token zum Abrufen der nächsten Ergebnisseite |
Geografische Koordinaten (Breiten- und Längengrad) in eine lesbare Adresse umwandeln
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
lat | number | Ja | Breitengrad-Koordinate |
lng | number | Ja | Längengrad-Koordinate |
language | string | Nein | Sprachcode für Ergebnisse (z. B. en, es, fr) |
| Parameter | Typ | Beschreibung |
|---|
formattedAddress | string | Die formatierte Adresszeichenfolge |
placeId | string | Google Place ID für diesen Standort |
addressComponents | array | Detaillierte Adresskomponenten |
↳ longName | string | Vollständiger Name der Komponente |
↳ shortName | string | Abgekürzter Name |
↳ types | array | Komponententypen |
types | array | Adresstypen (z. B. street_address, route) |
GPS-Koordinaten auf das nächstgelegene Straßensegment ausrichten
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel mit aktivierter Roads API |
path | string | Ja | Durch Pipe getrennte Liste von Breiten-/Längengrad-Koordinaten (z. B. "60.170880,24.942795|60.170879,24.942796") |
interpolate | boolean | Nein | Ob zusätzliche Punkte entlang der Straße interpoliert werden sollen |
| Parameter | Typ | Beschreibung |
|---|
snappedPoints | array | Array von ausgerichteten Punkten auf Straßen |
↳ location | object | Ausgerichtete Standortkoordinaten |
↳ lat | number | Breitengrad |
↳ lng | number | Längengrad |
↳ originalIndex | number | Index im ursprünglichen Pfad (falls nicht interpoliert) |
↳ placeId | string | Place ID für dieses Straßensegment |
warningMessage | string | Warnmeldung, falls vorhanden (z. B. wenn Punkte nicht ausgerichtet werden konnten) |
Geschwindigkeitsbegrenzungen für Straßenabschnitte abrufen. Erfordert entweder Pfadkoordinaten oder placeIds.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel mit aktivierter Roads API |
path | string | Nein | Pipe-getrennte Liste von Breiten-/Längengrad-Koordinaten (erforderlich, wenn placeIds nicht angegeben) |
placeIds | array | Nein | Array von Place-IDs für Straßenabschnitte (erforderlich, wenn path nicht angegeben) |
| Parameter | Typ | Beschreibung |
|---|
speedLimits | array | Array von Geschwindigkeitsbegrenzungen für Straßenabschnitte |
↳ placeId | string | Place-ID für den Straßenabschnitt |
↳ speedLimit | number | Wert der Geschwindigkeitsbegrenzung |
↳ units | string | Einheit der Geschwindigkeitsbegrenzung (KPH oder MPH) |
snappedPoints | array | Array von angepassten Punkten, die den Geschwindigkeitsbegrenzungen entsprechen |
↳ location | object | Angepasste Standortkoordinaten |
↳ lat | number | Breitengrad |
↳ lng | number | Längengrad |
↳ originalIndex | number | Index im ursprünglichen Pfad |
↳ placeId | string | Place-ID für diesen Straßenabschnitt |
Zeitzoneninformationen für einen Standort abrufen
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel |
lat | number | Ja | Breitengrad-Koordinate |
lng | number | Ja | Längengrad-Koordinate |
timestamp | number | Nein | Unix-Zeitstempel zur Bestimmung des DST-Offsets (Standard: aktuelle Zeit) |
language | string | Nein | Sprachcode für Zeitzonennamen (z. B. en, es, fr) |
| Parameter | Typ | Beschreibung |
|---|
timeZoneId | string | IANA-Zeitzonen-ID (z. B. "America/New_York", "Europe/London") |
timeZoneName | string | Lokalisierter Zeitzonenname (z. B. "Östliche Sommerzeit") |
rawOffset | number | UTC-Versatz in Sekunden (ohne Sommerzeit) |
dstOffset | number | Sommerzeitversatz in Sekunden (0, wenn keine Sommerzeit) |
totalOffsetSeconds | number | Gesamter UTC-Versatz in Sekunden (rawOffset + dstOffset) |
totalOffsetHours | number | Gesamter UTC-Versatz in Stunden (z. B. -5 für EST, -4 für EDT) |
Postanschrift validieren und standardisieren
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
apiKey | string | Ja | Google Maps API-Schlüssel mit aktivierter Address Validation API |
address | string | Ja | Die zu validierende Adresse (als einzelne Zeichenfolge) |
regionCode | string | Nein | ISO 3166-1 Alpha-2-Ländercode (z. B. "US", "CA") |
locality | string | Nein | Stadt- oder Ortsname |
enableUspsCass | boolean | Nein | USPS CASS-Validierung für US-Adressen aktivieren |
| Parameter | Typ | Beschreibung |
|---|
formattedAddress | string | Die standardisierte formatierte Adresse |
lat | number | Breitengradkoordinate |
lng | number | Längengradkoordinate |
placeId | string | Google Place ID für diese Adresse |
addressComplete | boolean | Ob die Adresse vollständig und zustellbar ist |
hasUnconfirmedComponents | boolean | Ob einige Adresskomponenten nicht bestätigt werden konnten |
hasInferredComponents | boolean | Ob einige Komponenten abgeleitet wurden (nicht in der Eingabe) |
hasReplacedComponents | boolean | Ob einige Komponenten durch kanonische Werte ersetzt wurden |
validationGranularity | string | Granularität der Validierung (PREMISE, SUB_PREMISE, ROUTE usw.) |
geocodeGranularity | string | Granularität des Geocode-Ergebnisses |
addressComponents | array | Detaillierte Adresskomponenten |
↳ longName | string | Vollständiger Name der Komponente |
↳ shortName | string | Abgekürzter Name |
↳ types | array | Komponententypen |
missingComponentTypes | array | Typen von Adresskomponenten, die fehlen |
unconfirmedComponentTypes | array | Typen von Komponenten, die nicht bestätigt werden konnten |
unresolvedTokens | array | Eingabe-Tokens, die nicht aufgelöst werden konnten |