Werkzeugreferenz

Alle 42 Werkzeuge mit sämtlichen Parametern, Standardwerten, Grenzen und Beispielen. Dieselbe Schnittstelle steht über MCP und CLI bereit.

Aufrufkonventionen

Die Beispiele sind MCP-Argumentobjekte. Bei einem direkten MCP-Aufruf tools/call setzen Sie den Werkzeugnamen in name und das Objekt in arguments. Hosts können Werkzeugnamen voranstellen. Die entsprechenden CLI-Aufrufe unten verwenden mcp-gmap-rs call TOOL --args JSON.

Nur Parameter der obersten Ebene haben CLI-Optionen. Übergeben Sie verschachtelte Objekte und Arrays als JSON. Eine alleinstehende boolesche Option bedeutet true; --flag false setzt false. Unbekannte Eigenschaften werden abgewiesen. Prüfen Sie die installierte Version mit tools oder schema TOOL.

Google-Authentifizierung und Sprache sind Prozesskonfiguration, keine Werkzeugparameter. Exakte Routenkoordinaten vermeiden die Adressauflösung; benannte Orte können zusätzlich einen API-Schlüssel für Geocoding benötigen. Siehe Authentifizierung und Konfiguration.

Aufrufe können Google-Kosten verursachen. Zusammengesetzte und Matrixergebnisse können trotz erfolgreichem Werkzeugaufruf Fehler pro Element enthalten. Erhalten Sie Google-Quelllinks, Bewertungs-/Fotoautoren und KI-Zusammenfassungshinweise. Beispiele zeigen Eingaben, keine garantierten aktuellen Ergebnisse oder Abdeckungen.

Typen, Pflichtfelder und Schema-Grenzen stammen aus der schemabasierten Programmreferenz. Standardwerte, Ergebnisbeschreibungen und feldübergreifende Einschränkungen werden anhand der Implementierung geprüft. Google kann zusätzliche Abdeckungs- und Kontingentgrenzen setzen.

Unbekannte Eigenschaften auf oberster Ebene werden abgelehnt; native API-Objekte akzeptieren Google-Felder, die Google validiert. Ändernde Operationen werden nicht automatisch wiederholt.

Werkzeuge

• maps_geocode
• maps_validate_address
• maps_pollen
• maps_area_insights
• maps_snap_to_roads
• maps_nearest_roads
• maps_reverse_geocode
• maps_search_places
• maps_search_nearby
• maps_place_details
• maps_directions
• maps_distance_matrix
• maps_elevation
• maps_timezone
• maps_weather
• maps_air_quality
• maps_static_map
• maps_batch_geocode
• maps_explore_area
• maps_plan_route
• maps_compare_places
• maps_search_along_route
• maps_local_rank_tracker
• maps_speed_limits
• maps_autocomplete
• maps_geolocate
• maps_solar
• maps_aerial_view
• maps_render_aerial_video
• maps_map_tiles
• maps_streetview
• maps_streetview_publish
• maps_datasets
• maps_route_optimization
• maps_air_quality_forecast
• maps_air_quality_history
• maps_air_quality_heatmap
• maps_pollen_heatmap
• maps_weather_history
• maps_weather_alerts
• maps_weather_minute_forecast
• maps_weather_map

maps_geocode

Adresse oder Sehenswürdigkeit in Koordinaten umwandeln.

Adresse oder Sehenswürdigkeit zum ersten Geocoding-Treffer auflösen. Liefert wiederverwendbare Koordinaten und eine Orts-ID, prüft aber keine postalische Zustellbarkeit.

CLI-Befehl: geocode. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
address / --address	Zeichenkette; mindestens 1 Zeichen	Ja	—	Aufzulösende Adresse, Stadt oder Sehenswürdigkeit.

Verhalten und Einschränkungen

• Kein Treffer ist ein Werkzeugfehler, kein erfolgreicher leerer Ort.
• Dieses direkte Werkzeug verwendet Geocoding v3. Places-Fallback wird von ortsauflösenden Kompositen verwendet, nicht von diesem Aufruf.

Ergebnis

Objekt mit location.lat, location.lng, formatted_address und place_id. Nur der erste Treffer wird zurückgegeben.

Beispiel

MCP-Argumente:

{
  "address": "Eiffel Tower, Paris, France"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_geocode --args '{"address":"Eiffel Tower, Paris, France"}'

maps_validate_address

Postadresse validieren und standardisieren; liefert Googles Urteil, Korrekturen, Bestandteile und Geocoding. Ein Urteil ist ein Hinweis, keine Zustellgarantie.

Postbestandteile prüfen und Korrekturen, standardisierte Adresse und Googles Urteil zurückgeben. Urteil und ungeklärte Bestandteile müssen für den Aufrufer sichtbar bleiben.

CLI-Befehl: validate-address. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
addressLines / --address-lines	Array von Zeichenketten; 1–10 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Eine oder mehrere Postadresszeilen in ihrer Reihenfolge.
administrativeArea / --administrative-area	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Bundesland, Provinz oder entsprechender Verwaltungsbereich.
enableUspsCass / --enable-usps-cass	boolescher Wert	Nein	false	USPS-CASS-Verarbeitung anfordern; bei true verlangt diese Implementierung regionCode US oder PR.
locality / --locality	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Stadt oder Ort.
postalCode / --postal-code	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Postleitzahl beziehungsweise ZIP-Code.
regionCode / --region-code	Zeichenkette; Muster: ^[A-Z]{2}$	Nein	Nicht angegeben; Google kann den Wert ableiten	Zweistelliger Länder-/Regionscode in Großbuchstaben; zur eindeutigen Adresszuordnung empfohlen.
sessionToken / --session-token	Zeichenkette; mindestens 1 Zeichen	Nein	Kein Token; Google rechnet außerhalb einer Autocomplete-Sitzung ab	Autocomplete-(New)-Token aus demselben Projekt. Vorhersagetoken in diesem abschließenden Aufruf wiederverwenden; für die nächste Sitzung ein neues erzeugen.

Verhalten und Einschränkungen

• Ein Validierungsurteil ist keine Zustellgarantie.
• Regions-/API-Abdeckung variiert. Das Werkzeug sendet keine Validierungsrückmeldung und übernimmt Korrekturen nicht automatisch.

Ergebnis

Vollständige Validierungsantwort, gewöhnlich mit result.verdict, result.address, result.geocode und responseId; Google kann nicht verfügbare Felder auslassen.

Beispiel

MCP-Argumente:

{
  "addressLines": [
    "5 Avenue Anatole France"
  ],
  "regionCode": "FR",
  "locality": "Paris",
  "postalCode": "75007"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_validate_address --args '{"addressLines":["5 Avenue Anatole France"],"regionCode":"FR","locality":"Paris","postalCode":"75007"}'

maps_pollen

Pollenprognosen, Indizes und Gesundheitsempfehlungen für 1–5 Tage an exakten Koordinaten abrufen. Abdeckung hängt von Ort und Saison ab.

Kurze tägliche Pollenprognose für exakte Koordinaten abrufen. Pollenarten, Indizes, Pflanzeninformationen und Anbieterempfehlungen bleiben erhalten.

CLI-Befehl: pollen. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
days / --days	Ganzzahl; 1–5	Nein	1	Anzahl anzufordernder täglicher Prognoseeinträge.
latitude / --latitude	Zahl; -90.0–90.0	Ja	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
longitude / --longitude	Zahl; -180.0–180.0	Ja	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
plantsDescription / --plants-description	boolescher Wert	Nein	false	Ausführliche Pflanzenbeschreibungen und zugehörige Informationen einschließen, soweit verfügbar.

Verhalten und Einschränkungen

• Die Seitengröße beträgt 5 und deckt die maximal fünf angefragten Tage ab; weitere Seiten werden nicht automatisch geladen.
• Verfügbarkeit hängt von Ort, Saison und Google-Abdeckung ab.

Ergebnis

Originale Pollen-Antwort mit regionCode, dailyInfo und gegebenenfalls nextPageToken. Jeder Tag kann Pollen- und Pflanzeninformationen enthalten.

Beispiel

MCP-Argumente:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "days": 3,
  "plantsDescription": false
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_pollen --args '{"latitude":48.8584,"longitude":2.2945,"days":3,"plantsDescription":false}'

maps_area_insights

Orte in Kreis, Region oder Polygon mit Places Aggregate zählen. Optionale Orts-IDs nur bei höchstens 100 Treffern; Details werden nicht automatisch abgefragt.

Passende Orte in Kreis, Region oder Polygon mit Places Aggregate zählen. Dies ist eine Aggregatabfrage, keine Zählung einer begrenzten Places-Ergebnisseite.

CLI-Befehl: area-insights. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
area / --area	Objekt	Ja	—	Genau eine Form aus circle, region oder customArea.
area.circle	Objekt	Nein	Nicht angegeben	Kreisgebiet; schließt region/customArea aus.
area.circle.latLng	Objekt	Wenn das übergeordnete Objekt angegeben ist	—	Kreismittelpunkt als exakte Koordinaten.
area.circle.latLng.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
area.circle.latLng.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
area.circle.radius	Ganzzahl; 23–50000	Wenn das übergeordnete Objekt angegeben ist	—	Kreisradius in Metern.
area.customArea	Objekt	Nein	Nicht angegeben	Benutzerdefiniertes Polygongebiet; schließt circle/region aus.
area.customArea.polygon	Objekt	Wenn das übergeordnete Objekt angegeben ist	—	Polygongrenze.
area.customArea.polygon.coordinates	Array von Objekten; 4–1000 Elemente	Wenn das übergeordnete Objekt angegeben ist	—	Geordneter Ring aus Koordinatenobjekten; erste und letzte Koordinate müssen übereinstimmen.
area.customArea.polygon.coordinates[].latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
area.customArea.polygon.coordinates[].longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
area.region	Objekt	Nein	Nicht angegeben	Verwaltungs-/Geografieregion als Google-Ortsressource.
area.region.place	Zeichenkette; Muster: ^places/[A-Za-z0-9_-]+$	Wenn das übergeordnete Objekt angegeben ist	—	Regionsressource im Format places/PLACE_ID, kein frei formulierter Regionsname.
excludedTypes / --excluded-types	Array von Zeichenketten; 1–50 Elemente; jedes Element mindestens 1 Zeichen	Nein	Kein Filter für ausgeschlossene Typen	Auszuschließende Google-Ortstypen.
includePlaces / --include-places	boolescher Wert	Nein	false	Zusätzlich zum Zählwert passende Ortsressourcen-IDs anfordern.
includedTypes / --included-types	Array von Zeichenketten; 1–50 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Einzuschließende Google-Ortstypen, etwa restaurant oder cafe.
maxRating / --max-rating	Zahl; 1.0–5.0	Nein	Keine obere Bewertungsgrenze	Inklusive obere Bewertungsgrenze.
minRating / --min-rating	Zahl; 1.0–5.0	Nein	Keine untere Bewertungsgrenze	Inklusive untere Bewertungsgrenze; darf maxRating nicht übersteigen.
operatingStatus / --operating-status	Array von Zeichenketten; 1–3 Elemente; Werte: OPERATING_STATUS_OPERATIONAL, OPERATING_STATUS_PERMANENTLY_CLOSED, OPERATING_STATUS_TEMPORARILY_CLOSED	Nein	Google berücksichtigt standardmäßig aktive Betriebe	Zulässige Betriebszustände.
priceLevels / --price-levels	Array von Zeichenketten; 1–5 Elemente; Werte: PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE	Nein	Alle Preisstufen	Zulässige Preisstufen.

Verhalten und Einschränkungen

• Genau eine Gebietsform angeben. Verschachtelte Objekte werden in der CLI als JSON übergeben; untergeordnete Parameter haben keine eigenen Optionen.
• Polygonringe müssen geschlossen sein. Google prüft zusätzlich Geometrie, unterstützte Typen, Fläche und Abdeckung.
• Orts-IDs sind nur bei Zählwerten bis 100 verfügbar. Place Details wird nicht automatisch angefordert.

Ergebnis

Google-Antwort mit count (gewöhnlich eine int64-Zeichenkette) und optionalen Ressourcen placeInsights[].place, wenn IDs angefordert und verfügbar sind.

Beispiel

MCP-Argumente:

{
  "area": {
    "circle": {
      "latLng": {
        "latitude": 48.8584,
        "longitude": 2.2945
      },
      "radius": 500
    }
  },
  "includedTypes": [
    "restaurant"
  ],
  "minRating": 4
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_area_insights --args '{"area":{"circle":{"latLng":{"latitude":48.8584,"longitude":2.2945},"radius":500}},"includedTypes":["restaurant"],"minRating":4}'

maps_snap_to_roads

Geordnete GPS-Spur mit 2–100 Punkten Straßen zuordnen. Für gute Ergebnisse höchstens etwa 300 Meter zwischen Folgepunkten. Optionale Interpolation ergänzt Geometrie.

Geordnete GPS-Spur der wahrscheinlichsten Straßengeometrie zuordnen. Für unabhängige Punkte statt einer Fahrtspur Nearest Roads verwenden.

CLI-Befehl: snap-to-roads. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
interpolate / --interpolate	boolescher Wert	Nein	false	Zwischen eingegebenen Punkten zusätzliche Straßengeometrie ergänzen.
path / --path	Array von Objekten; 2–100 Elemente	Ja	—	GPS-Koordinatenobjekte in Fahrtreihenfolge.
path[].latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
path[].longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Aufeinanderfolgende Eingabepunkte sollten für gute Zuordnung etwa höchstens 300 Meter auseinanderliegen.
• Interpolierte Punkte haben möglicherweise keinen originalIndex. Das Werkzeug fragt keine Geschwindigkeitslimits ab.

Ergebnis

Originale Roads-Antwort mit snappedPoints und gegebenenfalls warningMessage. Punkte behalten placeId, location und originalIndex, soweit geliefert.

Beispiel

MCP-Argumente:

{
  "path": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ],
  "interpolate": true
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_snap_to_roads --args '{"path":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}],"interpolate":true}'

maps_nearest_roads

Nächste Straßenabschnitte für 1–100 unabhängige GPS-Punkte finden; Googles originalIndex und Straßen-Orts-IDs bleiben erhalten.

Nahe Straßenabschnitte für unabhängige GPS-Punkte finden, ohne die Punkte als durchgehende Spur zu interpretieren.

CLI-Befehl: nearest-roads. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
points / --points	Array von Objekten; 1–100 Elemente	Ja	—	Unabhängige Koordinatenobjekte für die Zuordnung.
points[].latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
points[].longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Ein Punkt kann mehreren Straßenabschnitten entsprechen; originalIndex erhalten und nicht genau ein Ergebnis pro Eingabe voraussetzen.
• Geschwindigkeitslimits werden nicht angefordert.

Ergebnis

Originale Roads-Antwort mit snappedPoints, Straßen-placeId, location und originalIndex zur Zuordnung zu Eingabepunkten.

Beispiel

MCP-Argumente:

{
  "points": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ]
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_nearest_roads --args '{"points":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}]}'

maps_reverse_geocode

Koordinaten in eine Straßenadresse umwandeln.

Exakte Koordinaten zum ersten Reverse-Geocoding-Ergebnis auflösen. Bestandteile verwenden, wenn eine formatierte Adresse nicht ausreicht.

CLI-Befehl: reverse-geocode. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
latitude / --latitude	Zahl; -90.0–90.0	Ja	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
longitude / --longitude	Zahl; -180.0–180.0	Ja	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Nur der erste Treffer wird zurückgegeben. Kein Treffer ist ein Werkzeugfehler.

Ergebnis

Erstes natives Geocoding-Ergebnis mit formatted_address, address_components, geometry und place_id, soweit verfügbar.

Beispiel

MCP-Argumente:

{
  "latitude": 48.8584,
  "longitude": 2.2945
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_reverse_geocode --args '{"latitude":48.8584,"longitude":2.2945}'

maps_search_places

Places (New) per Text mit optionalen Orts- und Bewertungsfiltern durchsuchen.

Places (New) per Text mit optionalen Orts-, Bewertungs- und Typfiltern durchsuchen. Zurückgegebene IDs für gezielte Detailabfragen verwenden.

CLI-Befehl: search-places. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
includedType / --included-type	Zeichenkette; mindestens 1 Zeichen	Nein	Kein Typfilter	Google-Ortstyp, etwa cafe.
locationBias / --location-bias	Objekt	Nein	Keine Ortsbevorzugung	Optionale kreisförmige Suchbevorzugung, keine harte geografische Grenze.
locationBias.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
locationBias.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
locationBias.radius	Zahl; 0.1–50000.0	Nein	5000	Bevorzugungsradius in Metern.
minRating / --min-rating	Zahl; 0.0–5.0	Nein	Kein Bewertungsfilter	Von Google angeforderte Mindestbenutzerbewertung.
openNow / --open-now	boolescher Wert	Nein	Keine Einschränkung nach Öffnungsstatus	Bei true auf aktuell geöffnete Orte begrenzen.
query / --query	Zeichenkette; mindestens 1 Zeichen	Ja	—	Natürlichsprachliche Ortssuche.

Verhalten und Einschränkungen

• Das Werkzeug fordert eine Seite mit 20 Ergebnissen an und gibt kein Seitentoken zurück oder folgt ihm automatisch.
• Fehlende Öffnungs- und Bewertungsdaten hängen von Google-Abdeckung ab; diese Suche ist kein vollständiges Verzeichnis.

Ergebnis

Array mit bis zu 20 Google-Place-Objekten mit ausgewählten Suchfeldern, Maps-/Quelllinks und Quellenmetadaten.

Beispiel

MCP-Argumente:

{
  "query": "coffee near Gare de Lyon, Paris",
  "openNow": true,
  "minRating": 4
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_search_places --args '{"query":"coffee near Gare de Lyon, Paris","openNow":true,"minRating":4}'

maps_search_nearby

Orte um eine Adresse oder exakte Koordinaten finden und nach Typ, Bewertung und Öffnungsstatus filtern.

Orte innerhalb eines begrenzten Radius um einen aufgelösten Mittelpunkt finden. Anders als Text Search gilt eine feste Kreisgrenze.

CLI-Befehl: search-nearby. Google-Zugriff: Places akzeptiert API-Schlüssel oder OAuth. Mittelpunkte als Adresse/Sehenswürdigkeit benötigen zusätzlich einen API-Schlüssel zur Geocoding-Auflösung.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
center / --center	Objekt	Ja	—	Mittelpunktangabe und Kennzeichen ihrer Interpretation.
center.isCoordinates	boolescher Wert	Nein	false	value als exakte Koordinaten ohne Geocoding behandeln.
center.value	Zeichenkette; mindestens 1 Zeichen	Wenn das übergeordnete Objekt angegeben ist	—	Adresse/Sehenswürdigkeit oder latitude,longitude-Zeichenkette bei isCoordinates true.
keyword / --keyword	Zeichenkette; mindestens 1 Zeichen	Nein	Kein Typfilter	Google-Ortstyp als includedTypes, etwa cafe; kein beliebiges Textschlüsselwort.
minRating / --min-rating	Zahl; 0.0–5.0	Nein	Kein Bewertungsfilter	Lokal auf zurückgegebene Orte angewendete Mindestbewertung.
openNow / --open-now	boolescher Wert	Nein	false	Nur Treffer mit currentOpeningHours.openNow true behalten.
radius / --radius	Zahl; 0.1–50000.0	Nein	1000	Suchradius in Metern.

Verhalten und Einschränkungen

• Beim Filtern gilt fehlender Öffnungsstatus nicht als geöffnet; fehlende Bewertung wird als 0 behandelt.
• Adressmittelpunkte benötigen Ortsauflösung; Koordinaten vermeiden diesen Zusatzaufruf.

Ergebnis

Array mit höchstens 20 ausgewählten Place-Objekten. Lokale Öffnungs-/Bewertungsfilter können die Liste weiter verkleinern.

Beispiel

MCP-Argumente:

{
  "center": {
    "value": "48.8584,2.2945",
    "isCoordinates": true
  },
  "keyword": "cafe",
  "radius": 500
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_search_nearby --args '{"center":{"value":"48.8584,2.2945","isCoordinates":true},"keyword":"cafe","radius":500}'

maps_place_details

Ortsdetails, Bewertungen und Quellen abrufen. Optionale Foto-URLs behalten Autorenangaben; Quellen und Hinweise zusammen mit Inhalten anzeigen.

Bekannte Orts-ID zu ausgewählten Details, Bewertungen und optionalen Foto-URLs erweitern. Autoren-/Quellinformationen und KI-Hinweise erhalten.

CLI-Befehl: place-details. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
maxPhotos / --max-photos	Ganzzahl; 0–10	Nein	0	Maximale Anzahl von Foto-Medien-URL-Abfragen.
placeId / --place-id	Zeichenkette; mindestens 1 Zeichen	Ja	—	Google-Orts-ID, optional mit dem Präfix places/.
sessionToken / --session-token	Zeichenkette; mindestens 1 Zeichen	Nein	Kein Token; Google rechnet außerhalb einer Autocomplete-Sitzung ab	Autocomplete-(New)-Token aus demselben Projekt. Vorhersagetoken in diesem abschließenden Aufruf wiederverwenden; für die nächste Sitzung ein neues erzeugen.

Verhalten und Einschränkungen

• Jedes ausgewählte Foto kann einen weiteren Aufruf verursachen; null Fotos vermeidet diese Anfragen.
• Das Werkzeug verwendet eine feste Detailfeldmaske, nicht sämtliche möglichen Google-Place-Felder. Nicht verfügbare Felder können fehlen.

Ergebnis

Natives Google-Place-Objekt für die angeforderte Feldmaske. Bei Fotos enthält photoUrls Medien-URLs mit Fotoautoren und Quelllinks.

Beispiel

MCP-Argumente:

{
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "maxPhotos": 1
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_place_details --args '{"placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","maxPhotos":1}'

maps_directions

Route zwischen Orten mit Verkehrsmodus, Zeit und Vermeidungsoptionen berechnen.

Route zwischen zwei Endpunkten berechnen und ausgewählte Google-Routendaten sowie normalisierte Gesamtwerte liefern.

CLI-Befehl: directions. Google-Zugriff: Routes/Places akzeptieren API-Schlüssel oder OAuth. Die Auflösung benannter Orte benötigt zusätzlich einen API-Schlüssel für Geocoding; exakte Koordinatenzeichenketten vermeiden diese Abfrage.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
arrival_time / --arrival-time	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Gewünschte Ankunft nach RFC 3339 mit Zeitzone; nur im Modus transit.
avoid_highways / --avoid-highways	boolescher Wert	Nein	false	Autobahnen vermeiden; true ist nur bei Autofahrten zulässig.
avoid_tolls / --avoid-tolls	boolescher Wert	Nein	false	Mautstraßen vermeiden; true ist nur bei Autofahrten zulässig.
departure_time / --departure-time	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Abfahrtszeitpunkt nach RFC 3339 einschließlich Z oder ausdrücklichem UTC-Offset.
destination / --destination	Zeichenkette; mindestens 1 Zeichen	Ja	—	Zieladresse/Sehenswürdigkeit oder exakte latitude,longitude-Zeichenkette.
mode / --mode	Zeichenkette; Werte: driving, walking, bicycling, transit	Nein	driving	Verkehrsmodus. Autofahrten berücksichtigen die Verkehrslage.
origin / --origin	Zeichenkette; mindestens 1 Zeichen	Ja	—	Startadresse/Sehenswürdigkeit oder exakte latitude,longitude-Zeichenkette.
polylineQuality / --polyline-quality	Zeichenkette; Werte: OVERVIEW, HIGH_QUALITY	Nein	HIGH_QUALITY bei trafficSegments=true; andernfalls Googles Standard OVERVIEW	Geometriequalität: OVERVIEW oder HIGH_QUALITY. Eine ausdrückliche Auswahl hat immer Vorrang, auch OVERVIEW zusammen mit trafficSegments=true. Steuert die Punktdichte unabhängig von Verkehrsberechnungen.
trafficSegments / --traffic-segments	boolescher Wert	Nein	false	Boolesche Zusatzoption nur für Autofahrten. Fordert TRAFFIC_ON_POLYLINE mit ENCODED_POLYLINE an; standardmäßig HIGH_QUALITY, sofern polylineQuality nicht ausdrücklich gewählt wird. Verkehrsdaten auf Polylinien lösen die teurere Compute Routes Enterprise-SKU aus; ohne Bedarf für Segmentdetails auf false lassen.

Verhalten und Einschränkungen

• departure_time und arrival_time dürfen nicht gemeinsam gesetzt werden. arrival_time wird nur bei transit akzeptiert.
• Vermeidungsoptionen erfordern driving. Google setzt zusätzliche Verkehrsmodus-, Zeit- und Regionsgrenzen.
• Eine nicht verfügbare Route wird ausdrücklich als Fehler gemeldet.
• Bei trafficSegments=true liefert Routes Intervalle mit NORMAL, SLOW oder TRAFFIC_JAM. Normalisierte Routen- und Etappensegmente beziehen sich jeweils auf die zugehörige Polylinie mit eigenen Punktindizes. Google verwendet [start,end); die Geometrie behält den gemeinsamen Endgrenzpunkt bei, damit die letzte Kante enthalten ist. Fehlende oder ungültige Abdeckung wird ausdrücklich gemeldet und nicht als normaler Verkehr ergänzt.
• segmentMetadata.retrievedAt ist die lokale Abrufzeit der Antwort, keine Beobachtungszeit des Verkehrsanbieters; trafficObservedAt ist null, da Routes diese Zeit nicht liefert. roadCategory und speedLimit sind null, da diese Routes-Antwort beide Werte nicht enthält. Es erfolgen weder implizite Roads-Aufrufe noch lokale Dauerfaktoren; die Zeiten bleiben Google-Prognosen.
• Verkehrssegmente sind optional und in diesem Programm nur für Autofahrten verfügbar. Die Option fordert verkehrsabhängige Polylinien an und löst Compute Routes Enterprise-Abrechnung aus. Intervallvertrag; aktuelle SKU-Auslöser.
• polylineQuality wählt Googles Geometriedetail: HIGH_QUALITY verwendet mehr Punkte, vergrößert die Antwort und kann die Latenz erhöhen. Ausdrückliches OVERVIEW bleibt mit trafficSegments=true gültig. Ohne ausdrückliche Auswahl verwenden Verkehrssegmente HIGH_QUALITY; andernfalls verwendet Google OVERVIEW. Das Programm erzeugt oder interpoliert keine zusätzlichen Details. Die Qualität ist unabhängig von extraComputations: HIGH_QUALITY allein aktiviert TRAFFIC_ON_POLYLINE nicht. Offizielle PolylineQuality-Definition.

Primärquellen: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

Ergebnis

Objekt mit routes, summary, total_distance (Meter), total_duration (Sekunden) und optionalen Optimierungsindizes. Routeneinträge enthalten ausgewählte Etappen, Schritte, Polylinie und Warnungen. Bei trafficSegments=true enthalten Routen und Etappen zusätzlich normalisierte segments und segmentMetadata.

Beispiel

MCP-Argumente:

{
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_directions --args '{"origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking"}'

maps_distance_matrix

Fahrentfernungen und -zeiten für alle Start-/Zielpaare vergleichen.

Entfernung und Dauer für jedes Start-/Zielpaar vergleichen. Einzelne Zellen und Fehler prüfen, statt eine erfolgreiche Antwort als vollständig anzusehen.

CLI-Befehl: distance-matrix. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
avoid_highways / --avoid-highways	boolescher Wert	Nein	false	Autobahnen vermeiden; true ist nur bei Autofahrten zulässig.
avoid_tolls / --avoid-tolls	boolescher Wert	Nein	false	Mautstraßen vermeiden; true ist nur bei Autofahrten zulässig.
departure_time / --departure-time	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Abfahrtszeitpunkt nach RFC 3339 einschließlich Z oder ausdrücklichem UTC-Offset.
destinations / --destinations	Array von Zeichenketten; 1–50 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Zielzeichenketten: Adressen oder exakte latitude,longitude-Paare.
mode / --mode	Zeichenkette; Werte: driving, walking, bicycling, transit	Nein	driving	Verkehrsmodus. Autofahrten berücksichtigen die Verkehrslage.
origins / --origins	Array von Zeichenketten; 1–50 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Startzeichenketten: Adressen oder exakte latitude,longitude-Paare.

Verhalten und Einschränkungen

• Höchstens 625 Start×Ziel-Paare; bei transit maximal 100.
• Insgesamt höchstens 50 Start-/Zielzeichenketten ohne Koordinaten. Einzelne Arraygrenzen heben diese Gesamtgrenzen nicht auf.
• Maut-/Autobahnvermeidung gilt nur für driving. arrival_time ist hier nicht verfügbar.
• Eine einzelne Matrix-HTTP-Anfrage kann mehrere Elemente abrechnen.

Ergebnis

Objekt mit origin_addresses, destination_addresses, zeilenweise angeordneten distances und durations sowie einem errors-Array. Erfolgreiche Werte sind Meter/Sekunden; fehlende oder fehlerhafte Zellen bleiben null.

Beispiel

MCP-Argumente:

{
  "origins": [
    "48.8584,2.2945"
  ],
  "destinations": [
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_distance_matrix --args '{"origins":["48.8584,2.2945"],"destinations":["48.8606,2.3376","48.8530,2.3499"],"mode":"walking"}'

maps_elevation

Geografische Höhen für Koordinaten abrufen.

Geografische Höhe an exakten Koordinatenpunkten abrufen.

CLI-Befehl: elevation. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
locations / --locations	Array von Objekten; 1–512 Elemente	Ja	—	Koordinatenobjekte, für die Höhen angefragt werden.
locations[].latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
locations[].longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Das Werkzeug liefert Googles Daten ohne Umrechnung der Höheneinheiten.

Ergebnis

Natives Elevation-Array results. Einträge können elevation in Metern, location und resolution enthalten.

Beispiel

MCP-Argumente:

{
  "locations": [
    {
      "latitude": 48.8584,
      "longitude": 2.2945
    }
  ]
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_elevation --args '{"locations":[{"latitude":48.8584,"longitude":2.2945}]}'

maps_timezone

Zeitzone, UTC-/Sommerzeitversatz und lokale Zeit abrufen.

Zeitzonenidentität sowie UTC-/Sommerzeitversatz zu einem Zeitpunkt bestimmen und daraus einen lokalen Zeitstempel ableiten.

CLI-Befehl: timezone. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
latitude / --latitude	Zahl; -90.0–90.0	Ja	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
longitude / --longitude	Zahl; -180.0–180.0	Ja	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
timestamp / --timestamp	Ganzzahl; 0–253402300799999	Nein	Aktuelle UTC-Zeit in Millisekunden	Millisekunden seit der Unix-Epoche, nicht Sekunden.

Verhalten und Einschränkungen

• Die Anfrage wandelt Millisekunden in ganze Sekunden um; Genauigkeit unter einer Sekunde bleibt nicht erhalten.
• Die lokale Zeit verwendet den zurückgegebenen Grund- und Sommerzeitversatz für den angefragten Zeitpunkt.

Ergebnis

Zeitzonenfelder wie timeZoneId, timeZoneName, rawOffset und dstOffset in Sekunden sowie abgeleitete localTime im RFC-3339-Format.

Beispiel

MCP-Argumente:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "timestamp": 1793448000000
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_timezone --args '{"latitude":48.8584,"longitude":2.2945,"timestamp":1793448000000}'

maps_weather

Aktuelles Wetter sowie tägliche oder stündliche Vorhersagen für Koordinaten abrufen.

Aktuelle Bedingungen oder eine Seite täglicher/stündlicher Vorhersagedaten für exakte Koordinaten anfordern.

CLI-Befehl: weather. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
forecastDays / --forecast-days	Ganzzahl; 1–10	Nein	5	Gewünschte Länge der Tagesvorhersage; nur für forecast_daily.
forecastHours / --forecast-hours	Ganzzahl; 1–240	Nein	24	Gewünschte Länge der Stundenvorhersage; nur für forecast_hourly.
latitude / --latitude	Zahl; -90.0–90.0	Ja	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
longitude / --longitude	Zahl; -180.0–180.0	Ja	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
type / --type	Zeichenkette; Werte: current, forecast_daily, forecast_hourly	Nein	current	Aktuelle Bedingungen, Tages- oder Stundenprognose auswählen.

Verhalten und Einschränkungen

• forecastDays wird bei anderen Typen ignoriert; forecastHours gilt nur bei forecast_hourly.
• Seitentokens werden nicht automatisch verfolgt. Der angeforderte Horizont kann mehr Einträge umfassen als eine Antwortseite.
• Abdeckung und verfügbare Vorhersagen hängen von Google ab.

Ergebnis

Native Weather-Antwort: je nach type aktuelle Wetterfelder, forecastDays oder forecastHours. Einheiten, Zeitstempel und gegebenenfalls nextPageToken erhalten.

Beispiel

MCP-Argumente:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "type": "forecast_daily",
  "forecastDays": 3
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_weather --args '{"latitude":48.8584,"longitude":2.2945,"type":"forecast_daily","forecastDays":3}'

maps_air_quality

Aktuelle Luftqualitätsindizes mit optionalen Schadstoffen und Gesundheitsempfehlungen abrufen.

Aktuelle Luftqualitätsindizes mit optionalen Schadstoffkonzentrationen und Gesundheitsempfehlungen des Anbieters abrufen.

CLI-Befehl: air-quality. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
includeHealthRecommendations / --include-health-recommendations	boolescher Wert	Nein	true	Berechnung von Googles Gesundheitsempfehlungen anfordern.
includePollutants / --include-pollutants	boolescher Wert	Nein	false	Schadstoffkonzentrationen anfordern.
latitude / --latitude	Zahl; -90.0–90.0	Ja	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
longitude / --longitude	Zahl; -180.0–180.0	Ja	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Empfehlungen sind Anbieterdaten, keine persönliche medizinische Beurteilung.
• Dieses Werkzeug bietet aktuelle Bedingungen, keine historischen oder Prognoseendpunkte.

Ergebnis

Native Air-Quality-Antwort zu aktuellen Bedingungen mit Indizes und optional healthRecommendations/pollutants, soweit von Google geliefert.

Beispiel

MCP-Argumente:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "includePollutants": true
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_air_quality --args '{"latitude":48.8584,"longitude":2.2945,"includePollutants":true}'

maps_static_map

PNG-Karte mit optionalen Markern und Pfaden erzeugen.

PNG-Karte mit optionalen Marker- und Pfadspezifikationen rendern.

CLI-Befehl: static-map. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
center / --center	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Mittelpunkt als Adresse oder latitude,longitude-Zeichenkette.
maptype / --maptype	Zeichenkette; Werte: roadmap, satellite, terrain, hybrid	Nein	roadmap	Grundkartenstil.
markers / --markers	Array von Zeichenketten; 1–100 Elemente; jedes Element mindestens 1 Zeichen	Nein	Keine Marker	Wiederholte Google-Static-Maps-Markerspezifikationen, etwa color:red|48.8584,2.2945.
path / --path	Array von Zeichenketten; 1–100 Elemente; jedes Element mindestens 1 Zeichen	Nein	Keine Pfade	Wiederholte Google-Static-Maps-Pfadspezifikationen, etwa color:blue|48.8584,2.2945|48.8606,2.3376.
size / --size	Zeichenkette; Muster: ^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$	Nein	600x400	Pixelmaße WIDTHxHEIGHT; die Laufzeit begrenzt jede Dimension auf 1–640.
zoom / --zoom	Ganzzahl; 0–21	Nein	Ausgelassen; Google wählt oder ermittelt den Wert	Ausdrückliche Zoomstufe.

Verhalten und Einschränkungen

• Mindestens eines von center, markers oder path ist erforderlich.
• Die vollständige Anfrage-URL darf höchstens 16.384 Zeichen haben. Das Schema-Größenmuster erlaubt mehr als die Laufzeitgrenze von 640 Pixeln.
• Marker-/Pfadgestaltung folgt der Google-Static-Maps-Syntax. Google-Quellenangaben bleiben im gerenderten Bild.

Ergebnis

MCP liefert eingebetteten image/png-Inhalt. Die CLI liefert JSON {mimeType,base64} oder mit --output rohe PNG-Bytes.

Beispiel

MCP-Argumente:

{
  "center": "48.8584,2.2945",
  "zoom": 14,
  "size": "320x240",
  "markers": [
    "color:red|48.8584,2.2945"
  ]
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_static_map --args '{"center":"48.8584,2.2945","zoom":14,"size":"320x240","markers":["color:red|48.8584,2.2945"]}'

maps_batch_geocode

Bis zu 50 Adressen auflösen und Erfolg oder Fehler je Adresse erhalten.

Begrenzte Adressliste geocodieren und dabei Eingabereihenfolge und Erfolg oder Fehler jedes Elements erhalten.

CLI-Befehl: batch-geocode. Google-Zugriff: Diese Implementierung benötigt einen API-Schlüssel.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
addresses / --addresses	Array von Zeichenketten; 1–50 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Aufzulösende Adress-/Sehenswürdigkeitszeichenketten.

Verhalten und Einschränkungen

• Begrenzte Parallelität mit höchstens fünf aktiven Google-Anfragen pro Prozess.
• Elementfehler erzwingen keinen CLI-Exitstatus ungleich null; success/error jeder Zeile prüfen.

Ergebnis

Array in Eingabereihenfolge. Jede Zeile enthält address, success und entweder data (Geocode-Objekt) oder error.

Beispiel

MCP-Argumente:

{
  "addresses": [
    "Paris, France",
    "London, UK"
  ]
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_batch_geocode --args '{"addresses":["Paris, France","London, UK"]}'

maps_explore_area

Ort auflösen und Kategorien mit Details zu führenden Treffern erkunden. Präzise Orte zur Routenplanung verwenden.

Einen Ort auflösen, ausgewählte Kategorien in seiner Umgebung suchen und nur die führenden Ergebnisse je Kategorie um Details erweitern.

CLI-Befehl: explore-area. Google-Zugriff: Places akzeptiert API-Schlüssel oder OAuth. Benannte Orte benötigen zusätzlich einen API-Schlüssel für Geocoding.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
location / --location	Zeichenkette; mindestens 1 Zeichen	Ja	—	Adresse/Sehenswürdigkeit oder exakte latitude,longitude-Zeichenkette.
radius / --radius	Zahl; 0.1–50000.0	Nein	1000	Suchradius je Kategorie in Metern.
topN / --top-n	Ganzzahl; 1–20	Nein	3	Maximale Anzahl je Kategorie mit Details zu erweiternder Orte.
types / --types	Array von Zeichenketten; 1–10 Elemente; jedes Element mindestens 1 Zeichen	Nein	restaurant, cafe, tourist_attraction	Zu suchende Google-Ortskategorien.

Verhalten und Einschränkungen

• Jede Kategorie sucht höchstens 20 Orte; count ist die Trefferzahl der Seite, kein aggregiertes Gesamtverzeichnis.
• Kategorie- und Detailfehler bleiben in einer erfolgreichen Gesamtausgabe sichtbar.
• Dieses zusammengesetzte Werkzeug stellt mehrere Google-Anfragen; Kategorien und topN auf die Aufgabe begrenzen.

Ergebnis

Objekt mit aufgelöster location, radius und categories. Jede Kategorie enthält type/count/top oder einen Fehler; erweiterte Orte können details_error enthalten.

Beispiel

MCP-Argumente:

{
  "location": "48.8584,2.2945",
  "types": [
    "cafe"
  ],
  "radius": 500,
  "topN": 1
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_explore_area --args '{"location":"48.8584,2.2945","types":["cafe"],"radius":500,"topN":1}'

maps_plan_route

Route durch 2–27 Stopps planen. 2–25 Zwischenstopps außer bei transit optimieren; exakte Koordinaten bleiben erhalten.

Einzelne Route durch geordnete Stopps planen; optional Google um Neuordnung der Zwischenstopps bei festen Endpunkten bitten.

CLI-Befehl: plan-route. Google-Zugriff: Routes/Places akzeptieren API-Schlüssel oder OAuth. Die Auflösung benannter Orte benötigt zusätzlich einen API-Schlüssel für Geocoding; exakte Koordinatenzeichenketten vermeiden diese Abfrage.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
avoid_highways / --avoid-highways	boolescher Wert	Nein	false	Autobahnen vermeiden; true ist nur bei Autofahrten zulässig.
avoid_tolls / --avoid-tolls	boolescher Wert	Nein	false	Mautstraßen vermeiden; true ist nur bei Autofahrten zulässig.
departure_time / --departure-time	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Abfahrtszeitpunkt nach RFC 3339 einschließlich Z oder ausdrücklichem UTC-Offset.
mode / --mode	Zeichenkette; Werte: driving, walking, bicycling, transit	Nein	driving	Verkehrsmodus. Autofahrten berücksichtigen die Verkehrslage.
optimize / --optimize	boolescher Wert	Nein	true, unter diesen Bedingungen	Zwischenstoppoptimierung anfordern, wenn mehr als drei Gesamtstopps vorliegen und der Modus nicht transit ist.
polylineQuality / --polyline-quality	Zeichenkette; Werte: OVERVIEW, HIGH_QUALITY	Nein	HIGH_QUALITY bei trafficSegments=true; andernfalls Googles Standard OVERVIEW	Geometriequalität: OVERVIEW oder HIGH_QUALITY. Eine ausdrückliche Auswahl hat immer Vorrang, auch OVERVIEW zusammen mit trafficSegments=true. Steuert die Punktdichte unabhängig von Verkehrsberechnungen.
stops / --stops	Array von Zeichenketten; 2–27 Elemente; jedes Element mindestens 1 Zeichen	Ja	—	Geordnete Adressen/Sehenswürdigkeiten oder exakte latitude,longitude-Zeichenketten; erster/letzter bleiben Endpunkte.
trafficSegments / --traffic-segments	boolescher Wert	Nein	false	Boolesche Zusatzoption nur für Autofahrten. Fordert TRAFFIC_ON_POLYLINE mit ENCODED_POLYLINE an; standardmäßig HIGH_QUALITY, sofern polylineQuality nicht ausdrücklich gewählt wird. Verkehrsdaten auf Polylinien lösen die teurere Compute Routes Enterprise-SKU aus; ohne Bedarf für Segmentdetails auf false lassen.

Verhalten und Einschränkungen

• Transit unterstützt nur zwei Endpunkte ohne Zwischenstopps.
• Optimierung wirkt erst ab vier Gesamtstopps, also mindestens zwei Zwischenstopps.
• Optimiert wird die Stoppreihenfolge einer Route, nicht die Fahrzeug-/Aufgabenverteilung einer Flotte.
• Bei trafficSegments=true liefert Routes Intervalle mit NORMAL, SLOW oder TRAFFIC_JAM. Normalisierte Routen- und Etappensegmente beziehen sich jeweils auf die zugehörige Polylinie mit eigenen Punktindizes. Google verwendet [start,end); die Geometrie behält den gemeinsamen Endgrenzpunkt bei, damit die letzte Kante enthalten ist. Fehlende oder ungültige Abdeckung wird ausdrücklich gemeldet und nicht als normaler Verkehr ergänzt.
• segmentMetadata.retrievedAt ist die lokale Abrufzeit der Antwort, keine Beobachtungszeit des Verkehrsanbieters; trafficObservedAt ist null, da Routes diese Zeit nicht liefert. roadCategory und speedLimit sind null, da diese Routes-Antwort beide Werte nicht enthält. Es erfolgen weder implizite Roads-Aufrufe noch lokale Dauerfaktoren; die Zeiten bleiben Google-Prognosen.
• Verkehrssegmente sind optional und in diesem Programm nur für Autofahrten verfügbar. Die Option fordert verkehrsabhängige Polylinien an und löst Compute Routes Enterprise-Abrechnung aus. Intervallvertrag; aktuelle SKU-Auslöser.
• polylineQuality wählt Googles Geometriedetail: HIGH_QUALITY verwendet mehr Punkte, vergrößert die Antwort und kann die Latenz erhöhen. Ausdrückliches OVERVIEW bleibt mit trafficSegments=true gültig. Ohne ausdrückliche Auswahl verwenden Verkehrssegmente HIGH_QUALITY; andernfalls verwendet Google OVERVIEW. Das Programm erzeugt oder interpoliert keine zusätzlichen Details. Die Qualität ist unabhängig von extraComputations: HIGH_QUALITY allein aktiviert TRAFFIC_ON_POLYLINE nicht. Offizielle PolylineQuality-Definition.

Primärquellen: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

Ergebnis

Objekt mit mode, wirksamem optimized, geordneten aufgelösten stops, Anzeige-legs, total_distance, total_duration, Polylinie und Warnungen. durationSeconds einer Etappe sind numerische Sekunden. Bei trafficSegments=true enthalten Routen und Etappen zusätzlich normalisierte segments und segmentMetadata.

Beispiel

MCP-Argumente:

{
  "stops": [
    "48.8584,2.2945",
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking",
  "optimize": false
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_plan_route --args '{"stops":["48.8584,2.2945","48.8606,2.3376","48.8530,2.3499"],"mode":"walking","optimize":false}'

maps_compare_places

Orte mit Detailinformationen und optionaler Fahrentfernung ab userLocation suchen und vergleichen.

Kurze Ortsauswahlliste suchen und anreichern; optional Fahrentfernungen ab exakten Benutzerkoordinaten vergleichen.

CLI-Befehl: compare-places. Google-Zugriff: Places und optional Routes akzeptieren API-Schlüssel oder OAuth.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
limit / --limit	Ganzzahl; 1–20	Nein	5	Maximale Anzahl anzureichernder passender Orte.
query / --query	Zeichenkette; mindestens 1 Zeichen	Ja	—	Places-Textsuchanfrage.
userLocation / --user-location	Objekt	Nein	Kein Entfernungs-/Zeitvergleich	Exakte Benutzerkoordinaten für einen optionalen Entfernungsvergleich.
userLocation.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
userLocation.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.

Verhalten und Einschränkungen

• Vergleichswege werden mit driving berechnet; dieses Werkzeug besitzt keinen konfigurierbaren Verkehrsmodus.
• Detail- und Entfernungsfehler bleiben erhalten, statt ansonsten verwendbare Orte zu entfernen.
• Nur die angeforderte Auswahlliste wird angereichert.

Ergebnis

Objekt mit places und optionalem distance_error. Orte können details/details_error, distance, drive_time und distance_errors je Ort enthalten.

Beispiel

MCP-Argumente:

{
  "query": "cafes near Eiffel Tower, Paris",
  "userLocation": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "limit": 3
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_compare_places --args '{"query":"cafes near Eiffel Tower, Paris","userLocation":{"latitude":48.8584,"longitude":2.2945},"limit":3}'

maps_search_along_route

Orte entlang einer Route anhand ihrer kodierten Polylinie finden.

Route berechnen und Places mit ihrer kodierten Polylinie durchsuchen, statt die Fahrt mit einer einzelnen Kreissuche anzunähern.

CLI-Befehl: search-along-route. Google-Zugriff: Routes/Places akzeptieren API-Schlüssel oder OAuth. Die Auflösung benannter Orte benötigt zusätzlich einen API-Schlüssel für Geocoding; exakte Koordinatenzeichenketten vermeiden diese Abfrage.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
destination / --destination	Zeichenkette; mindestens 1 Zeichen	Ja	—	Routenziel als Adresse/Sehenswürdigkeit oder exakte latitude,longitude-Zeichenkette.
maxResults / --max-results	Ganzzahl; 1–20	Nein	5	Maximale Anzahl angeforderter Places-Treffer auf der Antwortseite.
mode / --mode	Zeichenkette; Werte: driving, walking, bicycling, transit	Nein	walking	Verkehrsmodus der für die Suche verwendeten Route.
origin / --origin	Zeichenkette; mindestens 1 Zeichen	Ja	—	Routenstart als Adresse/Sehenswürdigkeit oder exakte latitude,longitude-Zeichenkette.
textQuery / --text-query	Zeichenkette; mindestens 1 Zeichen	Ja	—	Places-Suche nach Stopps entlang der Route, etwa Cafés oder Ladestationen.

Verhalten und Einschränkungen

• Standardmodus ist walking; directions, matrix und plan-route verwenden dagegen driving.
• Keine automatische Seitennavigation und keine Erweiterung um Place Details.
• Die Abfahrts-/Ankunfts- und Vermeidungsparameter von directions sind hier nicht verfügbar.

Ergebnis

Objekt mit places, optionalen routingSummaries und berechneter route einschließlich ausgewählter Google-Routendaten und normalisierter Gesamtwerte.

Beispiel

MCP-Argumente:

{
  "textQuery": "cafes",
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking",
  "maxResults": 3
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_search_along_route --args '{"textQuery":"cafes","origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking","maxResults":3}'

maps_local_rank_tracker

Suchrang für 1–3 Schlüsselwörter über ein geografisches Raster messen; liefert ARP, ATRP, SoLV und Fehler je Punkt.

Auftreten eines Zielorts unter den ersten 20 Text-Search-Ergebnissen an jedem Punkt eines geografischen Rasters messen.

CLI-Befehl: local-rank-tracker. Google-Zugriff: API-Schlüssel oder OAuth für die Haupt-API.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
center / --center	Objekt	Ja	—	Exakter Mittelpunkt des Abfragerasters.
center.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Breitengrad in Dezimalgrad; Norden ist positiv.
center.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	—	WGS84-Längengrad in Dezimalgrad; Osten ist positiv.
gridSize / --grid-size	Ganzzahl; 3–7	Nein	3	Anzahl Zeilen und Spalten; alle ganzzahligen Werte 3–7 sind zulässig.
gridSpacing / --grid-spacing	Zahl; 100.0–10000.0	Nein	1000	Abstand in Metern zwischen benachbarten Rasterpunkten.
keyword / --keyword	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Einzelnes Suchschlüsselwort; keyword oder keywords verwenden.
keywords / --keywords	Array von Zeichenketten; 1–3 Elemente; jedes Element mindestens 1 Zeichen	Nein	Nicht angegeben	Ein bis drei Suchschlüsselwörter; hat Vorrang, wenn beide Formen gesetzt sind.
placeId / --place-id	Zeichenkette; mindestens 1 Zeichen	Ja	—	ID des Zielorts, optional mit dem Präfix places/.

Verhalten und Einschränkungen

• Mindestens eines von keyword oder keywords ist erforderlich; einzelne Schemazeilen bilden diese Alternative nicht ab.
• Die Anfragezahl ist Schlüsselwortanzahl × gridSize², bis zu 147 vor Wiederholungen.
• Fehlgeschlagene Punkte werden aus Rangmetriken ausgeschlossen, nicht als gültige Nichttreffer gewertet. Ohne brauchbare Beobachtungen können Metriken null sein.
• Ein Suchrang ist keine Benutzerbewertung des Zielorts. Ergebnisse sind Stichproben ortsbevorzugter Textsuchen und keine Garantie des Google-Maps-Rangs eines Benutzers.

Ergebnis

Objekt mit target, grid_size, grid_spacing_m und Metriken/Raster je Schlüsselwort. ARP mittelt gefundene Ränge; ATRP verwendet Rang 21 für erfolgreiche Abfragen ohne Zieltreffer; SoLV ist der Anteil erfolgreicher Punkte mit Rang unter den ersten 3. failed_points und found_in zeigen die Abdeckung.

Beispiel

MCP-Argumente:

{
  "keyword": "cafe",
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "center": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "gridSize": 3,
  "gridSpacing": 500
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_local_rank_tracker --args '{"keyword":"cafe","placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","center":{"latitude":48.8584,"longitude":2.2945},"gridSize":3,"gridSpacing":500}'

maps_speed_limits

Geschwindigkeitsbegrenzungen für Pkw anhand von GPS-Punkten oder Roads-Segment-IDs abrufen. Diese eingeschränkte Google-Funktion erfordert Asset-Tracking-Zugang; die Roads-Aktivierung allein genügt nicht.

Geschwindigkeitsbegrenzungen für Pkw anhand von GPS-Punkten oder Roads-Segment-IDs abrufen. Diese eingeschränkte Google-Funktion erfordert Asset-Tracking-Zugang; die Roads-Aktivierung allein genügt nicht.

CLI-Befehl: speed-limits. Google-Zugriff: In dieser Implementierung ist auch im OAuth-Modus ein API-Schlüssel erforderlich. Die Speed-Limits-Berechtigung ist davon unabhängig.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
path / --path	Array von Objekten; 1–100 Elemente	Nein	Nicht angegeben	1 bis 100 GPS-Koordinaten; schließt roadPlaceIds aus. Google ordnet den Pfad Straßen zu.
path[].latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Für jeden Pfadpunkt erforderlich	WGS84-Breitengrad in Grad, -90 bis 90.
path[].longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Für jeden Pfadpunkt erforderlich	WGS84-Längengrad in Grad, -180 bis 180.
roadPlaceIds / --road-place-ids	Array von Zeichenketten; 1–100 Elemente; jedes Element mindestens 1 Zeichen	Nein	Nicht angegeben	1 bis 100 Straßenabschnitt-IDs aus maps_snap_to_roads oder maps_nearest_roads; normale Orts-IDs liefern eventuell keine Daten. Schließt path aus.
units / --units	Zeichenkette; Werte: KPH, MPH	Nein	KPH	Einheit: KPH (km/h) oder MPH (Meilen/h).

Verhalten und Einschränkungen

• Google beschränkt den Dienst auf Asset-Tracking-Lizenzen und bestimmte frühere Premium-Projekte mit dieser Berechtigung. API-Aktivierung und Abrechnung allein gewähren keinen Zugang. https://developers.google.com/maps/documentation/roads/speed-limits
• Jeder zurückgegebene speedLimits-Eintrag kann einzeln berechnet werden. Nur den kleinsten benötigten Stapel anfordern.
• Bei variablen Limits liefert Google den Pkw-Höchstwert. Daten sind nicht in Echtzeit und können fehlen oder veraltet sein; die Beschilderung beachten.
• Bei 403 bleibt der bereinigte Google-Fehler erhalten und wird um einen Zugangshinweis ergänzt. Schlüsselbeschränkungen, Berechtigungen und API-Aktivierung können ebenfalls die Ursache sein.

Primärquellen: https://developers.google.com/maps/documentation/roads/speed-limits

Ergebnis

Vollständige native Roads-Antwort mit speedLimits, Einheiten, optionalen snappedPoints, Warnungen und Google-Metadaten.

Beispiel

MCP-Argumente:

{
  "roadPlaceIds": [
    "ChIJs5ydyTiuEmsR0fRSlU0C7k0"
  ],
  "units": "KPH"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_speed_limits --args '{"roadPlaceIds":["ChIJs5ydyTiuEmsR0fRSlU0C7k0"],"units":"KPH"}'

maps_autocomplete

Orte und Suchanfragen während der Eingabe mit Places API (New), geografischen Filtern, Sprache, Cursorposition und vom Aufrufer verwalteten Sitzungstokens vorhersagen.

Orte und Suchanfragen während der Eingabe mit Places API (New), geografischen Filtern, Sprache, Cursorposition und vom Aufrufer verwalteten Sitzungstokens vorhersagen.

CLI-Befehl: autocomplete. Google-Zugriff: API-Schlüssel oder OAuth mit Places-/cloud-platform-Bereich.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
includeFutureOpeningBusinesses / --include-future-opening-businesses	boolescher Wert	Nein	false	Künftig eröffnende Unternehmen einschließen.
includePureServiceAreaBusinesses / --include-pure-service-area-businesses	boolescher Wert	Nein	false	Dienstleister ohne öffentliche Geschäftsadresse einschließen, die Kunden besuchen oder beliefern.
includeQueryPredictions / --include-query-predictions	boolescher Wert	Nein	false	Zusätzlich zu Orten auch Suchanfragen vorhersagen.
includedPrimaryTypes / --included-primary-types	Array von Zeichenketten; 0–5 Elemente; jedes Element mindestens 1 Zeichen	Nein	Alle Typen	Bis zu fünf primäre Ortstypen. (cities) oder (regions) muss allein stehen.
includedRegionCodes / --included-region-codes	Array von Zeichenketten; 0–15 Elemente	Nein	Alle Regionen	Bis zu 15 zweistellige CLDR-Regionscodes; Schnittmenge mit locationRestriction. Eine leere Liste schränkt nichts ein.
input / --input	Zeichenkette; mindestens 1 Zeichen	Ja	—	Nicht leerer Text, auch unvollständige Ortsnamen oder Adressen.
inputOffset / --input-offset	Ganzzahl; 0–4294967295	Nein	Eingabeende	Cursorposition als Unicode-Zeichenindex ab null; höchstens die Zeichenzahl des Textes.
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Konfiguriertes GOOGLE_MAPS_LANGUAGE	Bevorzugte IETF-BCP-47-Sprache; gemischte Sprachen sind möglich.
locationBias / --location-bias	Objekt	Nein	Google-IP-Gewichtung ohne geografische Option	Ergebnisse um genau einen Kreis oder ein Rechteck bevorzugen; Ergebnisse außerhalb sind möglich. Schließt locationRestriction aus.
locationBias.circle	Objekt	Nein	Nicht angegeben	Kreisförmiger Bereich; schließt rectangle aus.
locationBias.circle.center	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei circle erforderlich	WGS84-Kreismittelpunkt.
locationBias.circle.center.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei center erforderlich	Breitengrad des Mittelpunkts in Grad.
locationBias.circle.center.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei center erforderlich	Längengrad des Mittelpunkts in Grad.
locationBias.circle.radius	Zahl; 0.0–50000.0	Wenn das übergeordnete Objekt angegeben ist	Bei circle erforderlich	Radius in Metern, höchstens 50.000; bei locationRestriction positiv.
locationBias.rectangle	Objekt	Nein	Nicht angegeben	Geschlossenes Rechteck; schließt circle aus. Längengrade dürfen den Antimeridian überschreiten.
locationBias.rectangle.high	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei rectangle erforderlich	Nordöstliche Grenze.
locationBias.rectangle.high.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Breitengrad; low darf high nicht überschreiten.
locationBias.rectangle.high.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Längengrad; low > high bedeutet eine Antimeridianüberschreitung.
locationBias.rectangle.low	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei rectangle erforderlich	Südwestliche Grenze.
locationBias.rectangle.low.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Breitengrad; low darf high nicht überschreiten.
locationBias.rectangle.low.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Längengrad; low > high bedeutet eine Antimeridianüberschreitung.
locationRestriction / --location-restriction	Objekt	Nein	Google-IP-Gewichtung ohne geografische Option	Auf genau einen Kreis oder ein Rechteck beschränken. Schließt locationBias aus.
locationRestriction.circle	Objekt	Nein	Nicht angegeben	Kreisförmiger Bereich; schließt rectangle aus.
locationRestriction.circle.center	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei circle erforderlich	WGS84-Kreismittelpunkt.
locationRestriction.circle.center.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei center erforderlich	Breitengrad des Mittelpunkts in Grad.
locationRestriction.circle.center.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei center erforderlich	Längengrad des Mittelpunkts in Grad.
locationRestriction.circle.radius	Zahl; 0.0–50000.0	Wenn das übergeordnete Objekt angegeben ist	Bei circle erforderlich	Radius in Metern, höchstens 50.000; bei locationRestriction positiv.
locationRestriction.rectangle	Objekt	Nein	Nicht angegeben	Geschlossenes Rechteck; schließt circle aus. Längengrade dürfen den Antimeridian überschreiten.
locationRestriction.rectangle.high	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei rectangle erforderlich	Nordöstliche Grenze.
locationRestriction.rectangle.high.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Breitengrad; low darf high nicht überschreiten.
locationRestriction.rectangle.high.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Längengrad; low > high bedeutet eine Antimeridianüberschreitung.
locationRestriction.rectangle.low	Objekt	Wenn das übergeordnete Objekt angegeben ist	Bei rectangle erforderlich	Südwestliche Grenze.
locationRestriction.rectangle.low.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Breitengrad; low darf high nicht überschreiten.
locationRestriction.rectangle.low.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei Grenze erforderlich	WGS84-Längengrad; low > high bedeutet eine Antimeridianüberschreitung.
origin / --origin	Objekt	Nein	Entfernung entfällt	Referenzkoordinate für die geodätische Entfernung distanceMeters.
origin.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei origin erforderlich	WGS84-Breitengrad in Grad.
origin.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei origin erforderlich	WGS84-Längengrad in Grad.
regionCode / --region-code	Zeichenkette; Muster: ^[A-Za-z]{2}$	Nein	Nicht angegeben	Zweistelliger CLDR-Code für Formatierung und Rangfolge; keine Regionsbeschränkung.
sessionToken / --session-token	Zeichenkette; mindestens 1 Zeichen; Muster: ^[A-Za-z0-9_-]+$	Nein	Keine Sitzungsgruppierung; Einzelabrechnung	Vom Aufrufer erzeugtes URL-sicheres Token mit höchstens 36 ASCII-Zeichen; UUID v4 empfohlen. Im abschließenden Details- oder Address-Validation-Aufruf wiederverwenden.

Verhalten und Einschränkungen

• Der Aufrufer erzeugt und beendet Sitzungen. Alle Zugangsdaten einer Sitzung müssen zum selben Google-Cloud-Projekt gehören. Mit geeignetem Details- oder Address-Validation-Aufruf abschließen und danach ein neues Token verwenden; fehlende/wiederverwendete Tokens können Einzelabrechnung verursachen.
• Kreise: maximal 50 km, positiver Radius bei Beschränkungen. Rechteck-Breitengrade müssen geordnet sein; Antimeridianüberschreitung wird unterstützt.
• Google-Maps- und Anbieterangaben erhalten. EWR-Bedingungen und verfügbare Felder können abweichen. Referenz: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

Primärquellen: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

Ergebnis

Vollständige native suggestions-Antwort mit placePrediction/queryPrediction, Trefferpositionen, strukturiertem Text, IDs, optionaler Entfernung und Metadaten; keine Feldmaske entfernt Inhalte.

Beispiel

MCP-Argumente:

{
  "input": "coffee near Paris",
  "sessionToken": "550e8400-e29b-41d4-a716-446655440000",
  "includedRegionCodes": [
    "FR"
  ],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "radius": 5000
    }
  },
  "includeQueryPredictions": true
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_autocomplete --args '{"input":"coffee near Paris","sessionToken":"550e8400-e29b-41d4-a716-446655440000","includedRegionCodes":["FR"],"locationBias":{"circle":{"center":{"latitude":48.8566,"longitude":2.3522},"radius":5000}},"includeQueryPredictions":true}'

maps_geolocate

Geräteposition aus Mobilfunkzellen oder WLAN-Beobachtungen mit dem vollständigen nativen Google-Geolocation-JSON ermitteln.

Geräteposition aus Mobilfunkzellen oder WLAN-Beobachtungen mit dem vollständigen nativen Google-Geolocation-JSON ermitteln.

CLI-Befehl: geolocate. Google-Zugriff: API-Schlüssel erforderlich; www.googleapis.com erhält ihn auch bei POST als Abfrageparameter.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
body / --body	Objekt	Ja	—	Natives Google-Objekt mit homeMobileCountryCode, homeMobileNetworkCode, radioType (gsm/cdma/wcdma/lte/nr), carrier, considerIp, cellTowers, wifiAccessPoints, cellId/newRadioCellId und Signalwerten. Alle verschachtelten Felder stehen in der offiziellen Referenz. Ein leeres Objekt erlaubt Server-IP-Rückfall.

Verhalten und Einschränkungen

• Vollständiges Funk-/WLAN-Schema: https://developers.google.com/maps/documentation/geolocation/requests-geolocation
• Google verwendet standardmäßig considerIp=true. Der IP-Rückfall lokalisiert den Server-Netzausgang, nicht die Person. Mit body.considerIp=false abschalten.
• WLAN benötigt mindestens zwei physisch getrennte stationäre Zugangspunkte. Lokale/reservierte MAC-Adressen werden ausgeschlossen; mobile Hotspots liefern eventuell nichts.
• Der native Körper bleibt erweiterbar und wird von Google validiert; unbekannte äußere Parameter werden abgelehnt. NOT_FOUND ist möglich; accuracy prüfen.

Primärquellen: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

Ergebnis

location.lat/location.lng und accuracy als Unsicherheitsradius in Metern sowie zusätzliche native Felder.

Beispiel

MCP-Argumente:

{
  "body": {
    "considerIp": false,
    "wifiAccessPoints": [
      {
        "macAddress": "00:25:9c:cf:1c:ac",
        "signalStrength": -43
      },
      {
        "macAddress": "00:25:9c:cf:1c:ad",
        "signalStrength": -55
      }
    ]
  }
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_geolocate --args '{"body":{"considerIp":false,"wifiAccessPoints":[{"macAddress":"00:25:9c:cf:1c:ac","signalStrength":-43},{"macAddress":"00:25:9c:cf:1c:ad","signalStrength":-55}]}}'

maps_solar

Die drei wichtigsten Solar-Methoden nutzen: Erkenntnisse zum nächstgelegenen Gebäude, regionale Raster-Metadaten und begrenzte GeoTIFF-Downloads per Asset-ID.

Die drei wichtigsten Solar-Methoden nutzen: Erkenntnisse zum nächstgelegenen Gebäude, regionale Raster-Metadaten und begrenzte GeoTIFF-Downloads per Asset-ID.

CLI-Befehl: solar. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth. Dienstkonten benötigen die aktivierte API und serviceusage.services.use im Kontingentprojekt.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
additionalInsights / --additional-insights	Array von Zeichenketten; 0–1 Elemente; Werte: DETECTED_ARRAYS	Nein	Keine zusätzlichen Erkenntnisse	Optional DETECTED_ARRAYS für building_insights, um erkannte Solaranlagen abzurufen.
exactQualityRequired / --exact-quality-required	boolescher Wert	Nein	false	Für Erkenntnisse/Layer exakt die gewählte Qualität verlangen, statt höhere zu akzeptieren.
experiments / --experiments	Array von Zeichenketten; 0–1 Elemente; Werte: EXPANDED_COVERAGE	Nein	Keine Experimente	Optional EXPANDED_COVERAGE für Erkenntnisse/Layer; Google behandelt solche Anfragen als Vorabangebot.
id / --id	Zeichenkette; mindestens 1 Zeichen	Nein	— für geo_tiff	Undurchsichtige ID aus dem id-Parameter einer Solar-Layer-URL. Nur für geo_tiff erforderlich; keine URL übergeben.
location / --location	Objekt	Nein	Nicht angegeben	Gebäude- oder Regionsmittelpunkt; bei building_insights/data_layers erforderlich.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	WGS84-Breitengrad in Grad.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	WGS84-Längengrad in Grad.
operation / --operation	Zeichenkette; Werte: building_insights, data_layers, geo_tiff	Ja	—	building_insights, data_layers oder geo_tiff; nur die zur Operation passenden Parameter sind zulässig.
pixelSizeMeters / --pixel-size-meters	Zahl; Werte: 0.1, 0.25, 0.5, 1.0	Nein	0.1	Mindestpixelgröße: 0.1, 0.25, 0.5 oder 1.0 m; einzelne Layer können gröbere native Auflösung haben.
radiusMeters / --radius-meters	Zahl; unbegrenzt–1000	Nein	Nicht angegeben	Positiver Radius für data_layers, höchstens 1.000 m. Über 100 m: <= pixelSizeMeters × 1.000. Über 175 m: keine Monatsfluss- oder Stundenschatten-Layer.
requiredQuality / --required-quality	Zeichenkette; Werte: HIGH, MEDIUM, BASE	Nein	HIGH (Google-Standard)	Mindestqualität HIGH, MEDIUM oder BASE; BASE verwendet verbesserte Satellitenbilder. Die Abdeckung variiert.
view / --view	Zeichenkette; Werte: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS, FULL_LAYERS	Nein	FULL_LAYERS (Google-Standard)	Teilmenge: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS oder FULL_LAYERS.

Verhalten und Einschränkungen

• Methoden: https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get ; https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get
• Abdeckung und Qualität unterscheiden sich nach Land. Ohne Gebäude innerhalb von etwa 50 m ist NOT_FOUND möglich. https://developers.google.com/maps/documentation/solar/coverage
• Layer-URLs verfallen und benötigen Authentifizierung. Nur deren id an geo_tiff übergeben; Downloads verwenden ausschließlich solar.googleapis.com/v1/geoTiff:get, niemals beliebige Hosts.
• GeoTIFFs unterliegen 16 MiB sowie Anfragebudget und Werkzeugfrist. Bei Bedarf Radius verkleinern oder Pixel vergröbern. Rasterdekodierung und Anlagenplanung sind nicht enthalten.
• EXPANDED_COVERAGE ist ein Vorabexperiment. Für EWR-Abrechnungsprojekte können andere Bedingungen und Inhalte gelten. https://developers.google.com/maps/comms/eea/solar
• Separate Abrechnung und Kontingente gelten; die Aktivierung macht Aufrufe nicht kostenlos. Google-Maps-Attribution erhalten.

Primärquellen: https://developers.google.com/maps/comms/eea/solar, https://developers.google.com/maps/documentation/solar/coverage, https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest, https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get, https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

Ergebnis

building_insights/data_layers liefern vollständiges Google-JSON mit Bilddaten/-qualität, Solarpotenzial und temporären Raster-URLs ohne Zugangsdaten. geo_tiff liefert begrenzte Originalbytes mit MIME-Typ und erhaltenen HTTP-Metadaten; CLI-JSON verwendet base64.

Beispiel

MCP-Argumente:

{
  "operation": "data_layers",
  "location": {
    "latitude": 37.444,
    "longitude": -122.16
  },
  "radiusMeters": 100,
  "view": "IMAGERY_AND_ANNUAL_FLUX_LAYERS"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_solar --args '{"operation":"data_layers","location":{"latitude":37.444,"longitude":-122.16},"radiusMeters":100,"view":"IMAGERY_AND_ANNUAL_FLUX_LAYERS"}'

maps_aerial_view

Kurzlebige Wiedergabe-URLs oder Metadaten eines vorhandenen Aerial-View-Videos abrufen, ohne es herunterzuladen.

Kurzlebige Wiedergabe-URLs oder Metadaten eines vorhandenen Aerial-View-Videos abrufen, ohne es herunterzuladen.

CLI-Befehl: aerial-view. Google-Zugriff: In dieser Implementierung auch im OAuth-Modus API-Schlüssel erforderlich.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
address / --address	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Unterstützte US-Postadresse. Genau address oder videoId angeben.
operation / --operation	Zeichenkette; Werte: lookup, metadata	Nein	lookup	lookup liefert URLs und Metadaten und wird berechnet; metadata liefert keine URLs und ist kostenlos.
videoId / --video-id	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Zuvor erhaltene Aerial-View-Video-ID. Genau videoId oder address angeben.

Verhalten und Einschränkungen

• Nur US-Postadressen mit 3D-Abdeckung. NOT_FOUND bedeutet ein fehlendes Video; maps_render_aerial_video fordert die Erstellung separat an.
• metadata prüft den Status kostenlos ohne URLs. lookup wird berechnet; während des Renderns mit angemessenen Abständen abfragen.
• URLs verfallen schnell: bei jeder Anzeige neu abrufen. Google verbietet Herunterladen, Speichern und Zwischenspeichern der Videos; Video-IDs sind ausgenommen. https://developers.google.com/maps/documentation/aerial-view/lookup-video
• Google-Maps-Attribution bei der Wiedergabe erhalten. EWR-Bedingungen können abweichen. https://developers.google.com/maps/documentation/aerial-view/policies

Primärquellen: https://developers.google.com/maps/documentation/aerial-view/lookup-video, https://developers.google.com/maps/documentation/aerial-view/policies

Ergebnis

Native Google-Antwort mit Status, Metadaten und bei aktivem lookup Wiedergabe-URLs nach Format/Auflösung. metadata enthält keine Wiedergabe-URLs.

Beispiel

MCP-Argumente:

{
  "operation": "metadata",
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_aerial_view --args '{"operation":"metadata","address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_render_aerial_video

Aerial-View-Rendering für eine unterstützte US-Postadresse ausdrücklich asynchron anfordern; diese Aktion verändert die Google-Renderwarteschlange.

Aerial-View-Rendering für eine unterstützte US-Postadresse ausdrücklich asynchron anfordern; diese Aktion verändert die Google-Renderwarteschlange.

CLI-Befehl: render-aerial-video. Google-Zugriff: In dieser Implementierung auch im OAuth-Modus API-Schlüssel erforderlich.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
address / --address	Zeichenkette; mindestens 1 Zeichen	Ja	—	Unterstützte US-Postadresse für das Rendering.

Verhalten und Einschränkungen

• Die Aktion verändert Googles Warteschlange. Keine automatische Wiederholung, kein Warten auf Fertigstellung und kein Videodownload.
• Fortschritt mit maps_aerial_view und operation metadata prüfen; lookup erst für Wiedergabe-URLs verwenden.
• US-/3D-Abdeckung, Kontingente und Google-Bedingungen gelten; Aktivierung garantiert kein Rendering. https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo
• Videos weder herunterladen noch speichern oder zwischenspeichern; aktuelle kurzlebige URLs mit erforderlicher Attribution anzeigen.

Primärquellen: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

Ergebnis

Native Antwort mit Status und verfügbaren Metadaten. PROCESSING bedeutet laufende Verarbeitung; vorhandene Videos können sofort ACTIVE liefern.

Beispiel

MCP-Argumente:

{
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_render_aerial_video --args '{"address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_map_tiles

Map-Tiles-Sitzungen erstellen und 2D-, fotorealistische 3D- und Street-View-Ressourcen für einen Betrachter abrufen. Kein Renderer. Die Lizenz erlaubt Visualisierung, nicht maschinelle Interpretation, Bildanalyse, Geodatenextraktion oder Offline-Nutzung.

Map-Tiles-Sitzungen erstellen und 2D-, fotorealistische 3D- und Street-View-Ressourcen für einen Betrachter abrufen. Kein Renderer. Die Lizenz erlaubt Visualisierung, nicht maschinelle Interpretation, Bildanalyse, Geodatenextraktion oder Offline-Nutzung.

CLI-Befehl: map-tiles. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth mit abgerechnetem Kontingentprojekt. Map Tiles aktivieren; Dienstkonten benötigen Service-Usage-Rechte im Kontingentprojekt.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
east / --east	Zahl; -180.0–180.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Östlicher Längengrad; negatives east und positives west können den Antimeridian kreuzen.
fov / --fov	Zahl; 30.0–120.0	Nein	90	Horizontales Sichtfeld der Vorschau, 30–120 Grad.
height / --height	Ganzzahl; 16–250	Nein	250	Vorschauhöhe, 16–250 Pixel.
latitude / --latitude	Zahl; -90.0–90.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Suchbreitengrad für streetview_metadata; benötigt longitude und schließt panoId aus.
locations / --locations	Array von Objekten; 1–100 Elemente	Nein	Nicht angegeben; bei genannten Operationen erforderlich	1 bis 100 Suchobjekte mit lat und lng für streetview_pano_ids.
locations[].lat	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Nicht angegeben; bei genannten Operationen erforderlich	WGS84-Breitengrad des Suchmittelpunkts.
locations[].lng	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Nicht angegeben; bei genannten Operationen erforderlich	WGS84-Längengrad des Suchmittelpunkts.
longitude / --longitude	Zahl; -180.0–180.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Suchlängengrad für streetview_metadata; benötigt latitude und schließt panoId aus.
north / --north	Zahl; -90.0–90.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Nördlicher WGS84-Breitengrad des Ausschnitts, größer als south.
operation / --operation	Zeichenkette; Werte: create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail, streetview_tile	Ja	—	create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail oder streetview_tile; bestimmt den Vertrag.
panoId / --pano-id	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Für Kacheln/Vorschaubilder erforderlich, für Metadaten alternativ zu Koordinaten. Kurzlebige ID nur innerhalb einer Nutzersitzung verwenden.
pitch / --pitch	Zahl; -90.0–90.0	Nein	0	Vertikale Vorschaurichtung, -90 bis 90 Grad.
radius / --radius	Zahl; 0.0–100000.0	Nein	50 Meter	Street-View-Suchradius bei Koordinaten in Metern; ganzzahlig 0–100000. Bei Metadaten nicht mit panoId kombinierbar.
resourceUrl / --resource-url	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Absolute Google-URL https://tile.googleapis.com/v1/3dtiles/... für resource_3d; keine fremden Hosts, Ports, Benutzerangaben, Fragmente oder kodierten Segmente. Empfangene Schlüssel werden durch konfigurierte Zugangsdaten ersetzt.
session / --session	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	createSession-Token für 2D und Street View, nicht 3D. Zurückgegebenen Ablauf beachten.
sessionOptions / --session-options	Objekt	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Native Google-Optionen für create_session; mapType, language und region erforderlich.
sessionOptions.highDpi	boolescher Wert	Nein	false	Pixelmaße bei 2x/4x vergrößern; bei 1x ohne Wirkung.
sessionOptions.imageFormat	Zeichenkette; Werte: jpeg, png	Nein	Google wählt das beste Format	Kodierung jpeg oder png; JPEG unterstützt keine Transparenz.
sessionOptions.language	Zeichenkette; mindestens 1 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Nicht angegeben; bei genannten Operationen erforderlich	IETF-Sprachtag, etwa de-DE.
sessionOptions.layerTypes	Array von Zeichenketten; 1–3 Elemente; Werte: layerRoadmap, layerStreetview, layerTraffic	Nein	Keine zusätzlichen Layer	Ein bis drei Werte aus layerRoadmap, layerStreetview, layerTraffic. terrain erfordert layerRoadmap.
sessionOptions.mapType	Zeichenkette; Werte: roadmap, satellite, terrain, streetview	Wenn das übergeordnete Objekt angegeben ist	Nicht angegeben; bei genannten Operationen erforderlich	roadmap, satellite, terrain oder streetview; terrain benötigt layerRoadmap in layerTypes.
sessionOptions.overlay	boolescher Wert	Nein	false	layerTypes ohne Basisbild darstellen.
sessionOptions.region	Zeichenkette; Muster: ^[A-Z]{2}$	Wenn das übergeordnete Objekt angegeben ist	Nicht angegeben; bei genannten Operationen erforderlich	Zwei CLDR-Großbuchstaben für den tatsächlichen Aufenthaltsort des Nutzers.
sessionOptions.scale	Zeichenkette; Werte: scaleFactor1x, scaleFactor2x, scaleFactor4x	Nein	scaleFactor1x	scaleFactor1x, scaleFactor2x oder scaleFactor4x bestimmt die Elementgröße.
sessionOptions.styles	Array von Objekten; 1–100 Elemente	Nein	Google-Standardstil	Native Google-JSON-Stile, nur für roadmap. https://developers.google.com/maps/documentation/tile/style-reference
south / --south	Zahl; -90.0–90.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Südlicher WGS84-Breitengrad des Ausschnitts.
west / --west	Zahl; -180.0–180.0	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Westlicher Längengrad des Ausschnitts.
width / --width	Ganzzahl; 16–600	Nein	600	Vorschaubreite, 16–600 Pixel.
x / --x	Ganzzahl; 0–4194303	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Kachelspalte; bei 2D x < 2^zoom, bei Street View Grenzen laut Panoramamaßen.
y / --y	Ganzzahl; 0–4194303	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Kachelzeile; bei 2D y < 2^zoom, bei Street View Grenzen laut Panoramamaßen.
yaw / --yaw	Zahl; -360.0–360.0	Nein	0	Horizontale Vorschaurichtung, -360 bis 360 Grad.
zoom / --zoom	Ganzzahl; 0–22	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Ganzzahliger Zoom 0–22 für tile_2d/viewport, 0–5 für streetview_tile. Maximum in viewport prüfen.

Verhalten und Einschränkungen

• create_session benötigt sessionOptions; tile_2d: session/zoom/x/y; viewport: session/zoom/north/south/east/west; root_3d: keine weiteren Felder; resource_3d: resourceUrl; streetview_pano_ids: session/locations; streetview_metadata: session und panoId oder latitude+longitude; streetview_thumbnail: session/panoId; streetview_tile: session/panoId/zoom/x/y. Unbenutzte Felder werden abgelehnt.
• Sitzungserstellung wird nicht automatisch wiederholt. Panoramaabfragen sind lesende POSTs. Der Client muss Kacheln zusammensetzen und 3D rendern.
• Nur Visualisierung. Kein unzulässiges Vorabladen, Indexieren, Speichern/Zwischenspeichern oder automatisches Analysieren durch Agenten. Cache-Control, ETag und Google-Vertrag beachten. https://developers.google.com/maps/documentation/tile/policies
• Google-Maps-Logo und Quellen anzeigen: viewport-Copyright für 2D; Street-View-Metadaten-Copyright und Problemmeldelink; Kachel-Copyright für 3D. Angaben nicht verdecken.
• Abdeckung, EWR-Bedingungen, Abrechnung und Kontingente variieren. Der native Sitzungsablauf ist maßgeblich, panoId ist kurzlebig. Kein Cache, Massendownload, Offline-Modus oder Bildanalyse.
• Verträge: https://developers.google.com/maps/documentation/tile/session_tokens ; https://developers.google.com/maps/documentation/tile/2d-tiles-overview ; https://developers.google.com/maps/documentation/tile/streetview ; https://developers.google.com/maps/documentation/tile/3d-tiles

Primärquellen: https://developers.google.com/maps/documentation/tile/2d-tiles-overview, https://developers.google.com/maps/documentation/tile/3d-tiles, https://developers.google.com/maps/documentation/tile/get-api-key, https://developers.google.com/maps/documentation/tile/policies, https://developers.google.com/maps/documentation/tile/session_tokens, https://developers.google.com/maps/documentation/tile/streetview, https://developers.google.com/maps/documentation/tile/style-reference

Ergebnis

Natives Google-JSON für Sitzungen, Ausschnitte, Panoramen und 3D-Kachelsätze. Attribution, Copyright, reportProblemLink und Ablauf bleiben erhalten. Binäre Bilder/3D-Ressourcen behalten MIME- und Cache-/ETag-Daten; MCP zeigt unterstützte Bilder, sonst base64. CLI --output schreibt Originalbytes.

Beispiel

MCP-Argumente:

{
  "operation": "root_3d"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_map_tiles --args '{"operation":"root_3d"}'

maps_streetview

Street-View-Panoramametadata prüfen oder ein statisches JPEG anhand von Ort oder Panorama-ID abrufen. Metadaten können vor einem kostenpflichtigen Bild die Verfügbarkeit klären.

Street-View-Panoramametadata prüfen oder ein statisches JPEG anhand von Ort oder Panorama-ID abrufen. Metadaten können vor einem kostenpflichtigen Bild die Verfügbarkeit klären.

CLI-Befehl: streetview. Google-Zugriff: API-Schlüssel und aktivierte Street View Static API erforderlich; OAuth allein genügt nicht. Google empfiehlt digitale Signaturen, bei manchen Konten sind sie Pflicht.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
fov / --fov	Zahl; 1.0–120.0	Nein	90	Horizontales Sichtfeld, 1–120 Grad.
heading / --heading	Zahl; 0.0–360.0	Nein	Google richtet auf den angegebenen Ort	Kompassrichtung der Kamera, 0 bis 360 Grad.
height / --height	Ganzzahl; 1–640	Nein	400	Bildhöhe, 1–640 Pixel, nur für image.
location / --location	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Adresse, Zeichenfolge latitude,longitude oder place_id:PLACE_ID. Genau location oder panoId angeben.
operation / --operation	Zeichenkette; Werte: metadata, image	Ja	—	metadata liefert JSON; image liefert JPEG-Bytes.
panoId / --pano-id	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Panorama-ID statt location; ursprünglichen Ort zum Erneuern veränderlicher IDs aufbewahren.
pitch / --pitch	Zahl; -90.0–90.0	Nein	0	Vertikaler Kamerawinkel, -90 bis 90 Grad.
radius / --radius	Ganzzahl; 0–100000	Nein	50	Ganzzahliger Suchradius in Metern, hier 0–100000.
returnErrorCode / --return-error-code	boolescher Wert	Nein	true in dieser Implementierung	Bei image HTTP-Fehler statt grauem Platzhalter bei fehlenden Bildern liefern.
signature / --signature	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben	Optionale URL-Signatur für exakt die kodierte Anfrage. Empfohlen, teilweise Pflicht; nur Weitergabe, keine Erzeugung. Bei signierten Anfragen steht signature zuletzt, nach dem API-Schlüssel. Signieren Sie den exakt kodierten Pfad und die Abfrage einschließlich erzeugter Standardwerte. Bildreihenfolge: location, radius, source, pano, size, heading, fov, pitch, return_error_code, key; fehlende optionale Felder entfallen. Metadaten lassen Bildfelder weg. Leerzeichen werden als + kodiert. Standard: size=640x400 und return_error_code=true.
source / --source	Zeichenkette; Werte: default, google, outdoor	Nein	default	Sammlung default, google oder outdoor; Verfügbarkeit nach Region.
width / --width	Ganzzahl; 1–640	Nein	640	Bildbreite, 1–640 Pixel, nur für image. Google-Sondergrößen sind nicht enthalten.

Verhalten und Einschränkungen

• Genau location oder panoId angeben. width, height, heading, fov, pitch und returnErrorCode gelten nur für image; ungenutzte Felder werden abgelehnt.
• Metadaten sind derzeit kostenlos und verbrauchen kein Bildkontingent; Bilder werden berechnet. https://developers.google.com/maps/documentation/streetview/metadata
• Eingebettete Attribution erhalten. Keine Drucknutzung; Speicher-/Cache-Beschränkungen gelten. Dieses Werkzeug erteilt keine Rechte zum Aufbewahren, Weiterverbreiten oder Analysieren. https://developers.google.com/maps/documentation/streetview/policies
• Eine übergebene Signatur wird weitergereicht, nicht erzeugt. Premium-Bildgrößen und Signierschlüsselkonfiguration sind nicht implementiert. https://developers.google.com/maps/documentation/streetview/request-streetview
• Abdeckung und EWR-Bedingungen variieren; Panorama-IDs und Aufnahmedaten können wechseln oder fehlen.

Primärquellen: https://developers.google.com/maps/documentation/streetview/metadata, https://developers.google.com/maps/documentation/streetview/policies, https://developers.google.com/maps/documentation/streetview/request-streetview

Ergebnis

Native Metadaten mit verfügbarem status, date, location, pano_id und Copyright oder JPEG-Bytes mit MIME- und sicheren Cache-Metadaten. Fehlende Bilder erzeugen standardmäßig Fehler. CLI --output speichert Bytes; MCP zeigt Bild und Metadaten.

Beispiel

MCP-Argumente:

{
  "operation": "metadata",
  "location": "Eiffel Tower, Paris, France"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_streetview --args '{"operation":"metadata","location":"Eiffel Tower, Paris, France"}'

maps_streetview_publish

Fotos und Sequenzen des zustimmenden Google-Nutzers mit allen dokumentierten v1-REST-Methoden und begrenztem Medienupload verwalten. Veröffentlichung und Löschung sind ausdrücklich und werden nie automatisch wiederholt.

Fotos und Sequenzen des zustimmenden Google-Nutzers mit allen dokumentierten v1-REST-Methoden und begrenztem Medienupload verwalten. Veröffentlichung und Löschung sind ausdrücklich und werden nie automatisch wiederholt.

CLI-Befehl: streetview-publish. Google-Zugriff: Nur Endnutzer-OAuth mit https://www.googleapis.com/auth/streetviewpublish. Explizite authorized_user-Datei über GOOGLE_APPLICATION_CREDENTIALS und OAuth-Modus verwenden. Dienstkonto, implizites ADC oder alleiniger API-Schlüssel werden abgelehnt. Zustimmung separat konfigurieren; dieses Programm erneuert Tokens, hostet aber keinen Browser-Callback.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
dataBase64 / --data-base64	Zeichenkette; mindestens 4 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Medienbytes als standardmäßiges aufgefülltes base64; dekodiert 1 Byte bis 8 MiB, eine Werkzeuggrenze und keine Google-Produktgrenze.
filter / --filter	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Google-Filter für list/list_sequences/get_sequence; methodenspezifische Grammatik.
inputType / --input-type	Zeichenkette; Werte: VIDEO, XDM	Nein	Nicht angegeben; bei genannten Operationen erforderlich	VIDEO oder XDM, für create_sequence erforderlich.
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Google-Standard	Bevorzugte Sprache für list/get/batch_get.
mimeType / --mime-type	Zeichenkette; Werte: image/jpeg, application/octet-stream, video/mp4	Nein	image/jpeg	Upload-Medientyp: image/jpeg, video/mp4 oder application/octet-stream.
operation / --operation	Zeichenkette; Werte: list, get, start_upload, upload, create, update, delete, batch_get, batch_update, batch_delete, list_sequences, get_sequence, start_sequence_upload, create_sequence, delete_sequence	Ja	—	list, get, start_upload, upload, create, update, delete, batch_get, batch_update, batch_delete, list_sequences, get_sequence, start_sequence_upload, create_sequence oder delete_sequence.
pageSize / --page-size	Ganzzahl; 1–100	Nein	Google-Dienststandard	Angeforderte Seitengröße 1–100 für list/list_sequences; Google kann weniger liefern.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Undurchsichtiges nextPageToken der vorigen Seite; ausdrückliche Seitennavigation.
photo / --photo	Objekt	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Google-Photo-JSON für create/update. create benötigt uploadReference.uploadUrl nach Upload; update benötigt separate photoId und updateMask. https://developers.google.com/streetview/publish/reference/rest/v1/photo
photoId / --photo-id	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Reine Foto-ID für get/update/delete, ohne Pfad oder URL-Parameter.
photoIds / --photo-ids	Array von Zeichenketten; 1–100 Elemente; jedes Element mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	1 bis 100 Foto-IDs für batch_get/batch_delete.
photoSequence / --photo-sequence	Objekt	Nein	Nicht angegeben; bei genannten Operationen erforderlich	PhotoSequence-JSON für create_sequence mit uploadReference.uploadUrl und formatabhängigen GPS-/CAMM-/IMU-/Aufnahmemetadaten. https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create
sequenceId / --sequence-id	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Sequenz-ID für get_sequence/delete_sequence; der Erstellungsoperationsname enthält sie.
updateMask / --update-mask	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Pflicht-FieldMask für update, etwa pose.heading oder pose.latLngPair.
updatePhotoRequests / --update-photo-requests	Array von Objekten; 1–100 Elemente	Nein	Nicht angegeben; bei genannten Operationen erforderlich	1 bis 100 native UpdatePhotoRequest-Objekte; jedes benötigt photo.photoId.id und updateMask.
uploadUrl / --upload-url	Zeichenkette; mindestens 1 Zeichen	Nein	Nicht angegeben; bei genannten Operationen erforderlich	Exakte HTTPS-UploadRef-URL aus start_upload/start_sequence_upload; nur streetviewpublish.googleapis.com/media/user/{account}/photo/{reference} oder photoSequence, ohne Umleitung, fremden Ursprung, Benutzerangaben, Fragment oder kodierte Segmente.
view / --view	Zeichenkette; Werte: BASIC, INCLUDE_DOWNLOAD_URL	Nein	BASIC	BASIC oder INCLUDE_DOWNLOAD_URL für list/get/batch_get/get_sequence. Private URLs werden nicht abgerufen.

Verhalten und Einschränkungen

• Fotoablauf: start_upload → upload mit dataBase64 → create mit photo.uploadReference.uploadUrl und Pflichtmetadaten. Upload allein veröffentlicht nichts. Bilder müssen Photo Sphere 360/XMP und Googles Annahmekriterien erfüllen. https://developers.google.com/streetview/publish/first-app
• update verwendet PUT und updateMask; Google erlaubt keine Pixeländerung. delete/batch_delete entfernen veröffentlichte Fotos. doctor und Live-Prüfungen schreiben, veröffentlichen, laden und löschen nichts.
• Sequenzablauf: start_sequence_upload → upload → create_sequence(inputType, photoSequence) → get_sequence. Videos überschreiten häufig 8 MiB; keine fortsetzbaren/gestückelten Uploads. Große Dateien extern über Google hochladen und UploadRef übergeben.
• GPS-, Pose-, IMU-, Verbindungs- und Ortsobjekte verwenden Google-Schemas. Unbekannte äußere Felder werden abgelehnt; Google validiert native Details. Jeder batch_update-Eintrag benötigt photo.photoId.id und updateMask.
• Dokumentierte Methoden: photo create/delete/get/startUpload/update; photos list/batchGet/batchUpdate/batchDelete; photoSequence create/delete/get/startUpload; photoSequences list. Nicht jedes native Feld wurde live geprüft. https://developers.google.com/streetview/publish/reference/rest
• Uploads sind begrenzt, an einen festen Host gebunden und ohne Wiederholung. Alle Mutationen deaktivieren Wiederholungen gegen doppelte öffentliche Änderungen. Ergebnisse prüfen.
• Zustimmung, Eigentum, Datenschutz, Copyright, 360-Annahme und Google-Kontingente gelten; Dienstkonto-IAM ersetzt keine Nutzerzustimmung. Veröffentlichung wurde mit dem vorhandenen Dienstkonto nicht live getestet. https://developers.google.com/streetview/publish/authorizing

Primärquellen: https://developers.google.com/streetview/publish/authorizing, https://developers.google.com/streetview/publish/first-app, https://developers.google.com/streetview/publish/reference/rest, https://developers.google.com/streetview/publish/reference/rest/v1/photo, https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create, https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate

Ergebnis

Natives Google-JSON für Photo, Listen/Seiten, UploadRef, Stapel oder langlaufende Operationen. Leere Upload-/Löschantworten werden {}. Status und Eigentümer bleiben erhalten. Sequenzen mit get_sequence prüfen; keine automatische Abfrage oder Veröffentlichung.

Beispiel

MCP-Argumente:

{
  "operation": "list",
  "pageSize": 10,
  "view": "BASIC"
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_streetview_publish --args '{"operation":"list","pageSize":10,"view":"BASIC"}'

maps_datasets

Geodatensätze für datenbasierte Google-Maps-Stile einschließlich asynchroner Importe aus vorhandenen Cloud-Storage-Objekten verwalten.

Geodatensätze für datenbasierte Google-Maps-Stile einschließlich asynchroner Importe aus vorhandenen Cloud-Storage-Objekten verwalten.

CLI-Befehl: datasets. Google-Zugriff: Nur OAuth 2.0 über Dienstkonto oder ADC mit https://www.googleapis.com/auth/cloud-platform. API-Schlüssel werden nicht akzeptiert. Rechte für Ressourcen- und Kontingentprojekt getrennt konfigurieren.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
dataset / --dataset	Objekt	Nein	Für create/update erforderlich	Natives Dataset-JSON für create/update. create benötigt eindeutigen displayName und usage:["USAGE_DATA_DRIVEN_STYLING"]. update übermittelt Metadaten mit passendem Ressourcennamen.
gcsSource / --gcs-source	Objekt	Nein	Für import erforderlich	Cloud-Storage-Importquelle, auf die der Aufrufer bereits Zugriff hat; keine lokalen Dateien.
gcsSource.fileFormat	Zeichenkette; Werte: FILE_FORMAT_GEOJSON, FILE_FORMAT_KML, FILE_FORMAT_CSV	Wenn das übergeordnete Objekt angegeben ist	Bei gcsSource erforderlich	Kodierung FILE_FORMAT_GEOJSON, FILE_FORMAT_KML oder FILE_FORMAT_CSV.
gcsSource.inputUri	Zeichenkette; mindestens 1 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Bei gcsSource erforderlich	Vorhandene gs://bucket/object-URI; storage.objects.get erforderlich, etwa Storage Object Viewer.
name / --name	Zeichenkette; Muster: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$	Nein	Für Ressourcenoperationen erforderlich	projects/{project}/datasets/{dataset}, außer list/create erforderlich. get akzeptiert zusätzlich @active für die letzte abgeschlossene Version.
operation / --operation	Zeichenkette; Werte: list, get, create, update, delete, import, download, fetch_errors	Ja	Erforderlich	list, get, create, update, delete, import, download oder fetch_errors. create/update/delete/import verändern Cloud-Ressourcen.
pageSize / --page-size	Ganzzahl; 1–500	Nein	list: 100; fetch_errors: Google-Standard 50	Maximale Datensätze/Fehler pro Seite; hier 1 bis 500.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Token der vorigen list-/fetch_errors-Seite; andere Argumente unverändert lassen.
parent / --parent	Zeichenkette; Muster: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$	Nein	Für list/create erforderlich	projects/{Projekt-ID oder -Nummer}, erforderlich für list/create.
tag / --tag	Zeichenkette; Werte: active	Nein	Neueste Version unabhängig vom Status	Für list liefert active die letzte abgeschlossene Version und überspringt Datensätze ohne solche Version.
updateMask / --update-mask	Zeichenkette; mindestens 1 Zeichen	Nein	Google verwendet * (vollständiger Metadatenaustausch)	Kommagetrennte Metadatenpfade für update, etwa description,displayName.
versionDescription / --version-description	Zeichenkette; mindestens 1 Zeichen	Nein	Ausgelassen	Beschreibung der neuen Version, nur für import.

Verhalten und Einschränkungen

• Schema und Rechte hängen von der Operation ab: mapsplatformdatasets.datasets.list/get/create/update/delete/import/export. https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets
• GCS-Import erstellt asynchron eine Version. Status mit get, Fehler mit fetch_errors prüfen; keine automatische Abfrage. https://developers.google.com/maps/documentation/datasets/create
• Öffentliches REST v1 dokumentiert kein listVersions. get für neueste Version, get mit @active und versionId verwenden; keine vollständige Versionshistorie zugesichert.
• download benötigt mapsplatformdatasets.datasets.export; CLI --output schreibt Bytes. https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download
• Maps Datasets hat keine Nutzungsgebühr, benötigt aber ein konfiguriertes Projekt; Google-Maps-Anzeige und Cloud Storage können kostenpflichtig sein. Vorgesehen für datenbasierte Stile. Kein lokaler Multipart-Upload; vorhandenes GCS-Objekt verwenden. https://developers.google.com/maps/documentation/datasets/overview

Primärquellen: https://developers.google.com/maps/documentation/datasets/create, https://developers.google.com/maps/documentation/datasets/overview, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets

Ergebnis

Natives Dataset-/Listen-/Fehler-JSON, importierter Versionsname oder Downloadbytes mit MIME-/Cache-Daten. get erhält status.state, status.errorMessage und versionId; Import bedeutet nicht abgeschlossene Verarbeitung.

Beispiel

MCP-Argumente:

{
  "operation": "list",
  "parent": "projects/my-project",
  "pageSize": 20
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_datasets --args '{"operation":"list","parent":"projects/my-project","pageSize":20}'

maps_route_optimization

Liefer- oder Serviceflotten mit Route Optimization und vollständigem nativem ShipmentModel einschließlich Kapazitäten, Zeitfenstern und Kostenbedingungen optimieren.

Liefer- oder Serviceflotten mit Route Optimization und vollständigem nativem ShipmentModel einschließlich Kapazitäten, Zeitfenstern und Kostenbedingungen optimieren.

CLI-Befehl: route-optimization. Google-Zugriff: Nur OAuth 2.0 über Dienstkonto oder ADC mit https://www.googleapis.com/auth/cloud-platform. API-Schlüssel werden nicht akzeptiert. Rechte für Ressourcen- und Kontingentprojekt getrennt konfigurieren.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
name / --name	Zeichenkette; Muster: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$	Nein	Für get_operation erforderlich	Exakter Google-Name projects/{project}[/locations/{location}]/operations/{ID}, für get_operation.
operation / --operation	Zeichenkette; Werte: optimize, validate, batch, optimize_long_running, optimize_uri, get_operation	Ja	Erforderlich	optimize löst synchron; validate setzt VALIDATE_ONLY; batch erstellt GCS-Job; optimize_long_running/optimize_uri sind experimentell; get_operation liest Status.
parent / --parent	Zeichenkette; Muster: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$	Nein	Außer get_operation erforderlich	projects/{ID}, optional /locations/-. Synchrone/langlaufende Optimierung lehnt konkrete Regionen ab; Stapel/URI akzeptieren native Ortsform.
request / --request	Objekt	Nein	Außer get_operation erforderlich	Vollständiger nativer Körper ohne parent. optimize/validate/optimize_long_running benötigen model mit shipments/vehicles und Bedingungen. batch: 1–100 modelConfigs, inputConfig.gcsSource.uri, outputConfig.gcsDestination.uri, JSON/PROTO_TEXT. URI: input.uri/output.uri als gs:// mit .json/.txtpb.

Verhalten und Einschränkungen

• validate ruft ebenfalls Google auf, löst aber das Modell nicht. Natives Schema: https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours
• API aktivieren. roles/routeoptimization.viewer erlaubt OptimizeTours und Lesen; editor zusätzlich Stapel. Rechte: routeoptimization.locations.use und routeoptimization.operations.create/get. https://developers.google.com/maps/documentation/route-optimization/cloud-setup
• Stapel lesen/schreiben GCS: Objekt-URIs und Speicherrechte angeben. Jobs können nach dem Aufruf weiterlaufen. Kein Dateiupload und keine automatische Abfrage. https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours
• Langlaufende und URI-Varianten sind experimentell; URI verwendet exakt :OptimizeToursUri. Vorabverhalten kann sich ändern. https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto
• Google unterstützt derzeit kein cancel/delete/list für Operationen; nur get_operation, keine Abbruchgarantie. https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations
• Abrechnung nach Sendungen und Single-Vehicle-/Fleet-Routing-SKUs, unabhängig von Routes-Wegpunktoptimierung. Ein Transport-Timeout bricht Jobs nicht ab. https://developers.google.com/maps/documentation/route-optimization/usage-and-billing

Primärquellen: https://developers.google.com/maps/documentation/route-optimization/cloud-setup, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours, https://developers.google.com/maps/documentation/route-optimization/usage-and-billing, https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto

Ergebnis

Native OptimizeToursResponse oder langlaufende Operation. Statusabfragen erhalten done:false, metadata und abschließende response-/error-Objekte ohne Fehler zu verbergen.

Beispiel

MCP-Argumente:

{
  "operation": "validate",
  "parent": "projects/my-project",
  "request": {
    "model": {
      "shipments": [],
      "vehicles": [
        {
          "startLocation": {
            "latitude": 48.85,
            "longitude": 2.35
          }
        }
      ]
    },
    "maxValidationErrors": 10
  }
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_route_optimization --args '{"operation":"validate","parent":"projects/my-project","request":{"model":{"shipments":[],"vehicles":[{"startLocation":{"latitude":48.85,"longitude":2.35}}]},"maxValidationErrors":10}}'

maps_air_quality_forecast

Stündliche Luftqualitätsprognosen für Zeitpunkt oder Intervall bis 96 Stunden abrufen.

Stündliche Luftqualitätsprognosen für Zeitpunkt oder Intervall bis 96 Stunden abrufen.

CLI-Befehl: air-quality-forecast. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
customLocalAqis / --custom-local-aqis	Array von Objekten; 1–250 Elemente	Nein	Google wählt lokale Indizes	Lokalen Index bestimmter ISO-Länder-/Regionscodes überschreiben.
customLocalAqis[].aqi	Zeichenkette; mindestens 1 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Für jede Überschreibung erforderlich	Unterstützter lokaler AQI-Code, etwa us_epa; Google validiert Kombinationen.
customLocalAqis[].regionCode	Zeichenkette; Muster: ^[A-Za-z]{2}$	Wenn das übergeordnete Objekt angegeben ist	Für jede Überschreibung erforderlich	Betroffener zweistelliger Länder-/Regionscode.
dateTime / --date-time	Zeichenkette; mindestens 20 Zeichen	Nein	Eine Zeitauswahl treffen	RFC3339-UTC-Zeitstempel mit Z, auf vorige Stunde abgerundet. Schließt period/hours aus.
extraComputations / --extra-computations	Array von Zeichenketten; 1–5 Elemente; Werte: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	Nein	Keine Zusatzberechnungen	LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION und/oder POLLUTANT_CONCENTRATION anfordern.
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Google: en	IETF-Sprache des Textes; Google wählt die nächste unterstützte Sprache.
location / --location	Objekt	Ja	Erforderlich	Ort der angefragten Bedingungen.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Breitengrad in Grad, -90 bis 90.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Längengrad in Grad, -180 bis 180.
pageSize / --page-size	Ganzzahl; 1–96	Nein	Google: Prognose 24; Historie 72	Maximale Stunden pro Seite: Prognose bis 96, Historie bis 168.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Vorheriges nextPageToken; andere Argumente unverändert lassen.
period / --period	Objekt	Nein	Eine Zeitauswahl treffen	Geordnetes inklusives Stundenintervall, höchstens 96 Prognose- oder 720 historische Stunden. Schließt dateTime/hours aus.
period.endTime	Zeichenkette; mindestens 20 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Bei period erforderlich	Inklusives RFC3339-UTC-Ende mit Z.
period.startTime	Zeichenkette; mindestens 20 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Bei period erforderlich	Gültiger RFC3339-UTC-Beginn mit Z.
uaqiColorPalette / --uaqi-color-palette	Zeichenkette; Werte: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	Nein	Google-Standardpalette	Universelle Palette RED_GREEN, INDIGO_PERSIAN_DARK oder INDIGO_PERSIAN_LIGHT. Lokale Paletten bleiben fest.
universalAqi / --universal-aqi	boolescher Wert	Nein	Google: true	Universellen Luftqualitätsindex einschließen.

Verhalten und Einschränkungen

• Referenz: https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup
• Genau eine Zeitauswahl erforderlich. Syntax, Reihenfolge und Höchstdauer werden lokal geprüft; Google prüft aktuelle Verfügbarkeit und Abdeckung.
• Eine Seite je Aufruf; nextPageToken ausdrücklich folgen. Indizes, Konzentrationen, Empfehlungen und Region bleiben erhalten.
• Attributions-, Anzeige- und Cache-Regeln beachten. Abdeckung und lokale Indizes variieren. https://developers.google.com/maps/documentation/air-quality/policies

Primärquellen: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

Ergebnis

Native Sammlung hourlyForecasts, regionCode und nextPageToken mit verfügbaren Schadstoffen und Empfehlungen.

Beispiel

MCP-Argumente:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "dateTime": "2026-11-01T12:00:00Z",
  "pageSize": 24
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_air_quality_forecast --args '{"location":{"latitude":48.85,"longitude":2.35},"dateTime":"2026-11-01T12:00:00Z","pageSize":24}'

maps_air_quality_history

Luftqualität der letzten 30 Tage abrufen.

Luftqualität der letzten 30 Tage abrufen.

CLI-Befehl: air-quality-history. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
customLocalAqis / --custom-local-aqis	Array von Objekten; 1–250 Elemente	Nein	Google wählt lokale Indizes	Lokalen Index bestimmter ISO-Länder-/Regionscodes überschreiben.
customLocalAqis[].aqi	Zeichenkette; mindestens 1 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Für jede Überschreibung erforderlich	Unterstützter lokaler AQI-Code, etwa us_epa; Google validiert Kombinationen.
customLocalAqis[].regionCode	Zeichenkette; Muster: ^[A-Za-z]{2}$	Wenn das übergeordnete Objekt angegeben ist	Für jede Überschreibung erforderlich	Betroffener zweistelliger Länder-/Regionscode.
dateTime / --date-time	Zeichenkette; mindestens 20 Zeichen	Nein	Eine Zeitauswahl treffen	RFC3339-UTC-Zeitstempel mit Z, auf vorige Stunde abgerundet. Schließt period/hours aus.
extraComputations / --extra-computations	Array von Zeichenketten; 1–5 Elemente; Werte: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	Nein	Keine Zusatzberechnungen	LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION und/oder POLLUTANT_CONCENTRATION anfordern.
hours / --hours	Ganzzahl; 1–720	Nein	Genau hours, dateTime oder period wählen	Vorherige Stunden, 1 bis 720 (30 Tage), schließt dateTime/period aus.
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Google: en	IETF-Sprache des Textes; Google wählt die nächste unterstützte Sprache.
location / --location	Objekt	Ja	Erforderlich	Ort der angefragten Bedingungen.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Breitengrad in Grad, -90 bis 90.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Längengrad in Grad, -180 bis 180.
pageSize / --page-size	Ganzzahl; 1–168	Nein	Google: Prognose 24; Historie 72	Maximale Stunden pro Seite: Prognose bis 96, Historie bis 168.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Vorheriges nextPageToken; andere Argumente unverändert lassen.
period / --period	Objekt	Nein	Eine Zeitauswahl treffen	Geordnetes inklusives Stundenintervall, höchstens 96 Prognose- oder 720 historische Stunden. Schließt dateTime/hours aus.
period.endTime	Zeichenkette; mindestens 20 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Bei period erforderlich	Inklusives RFC3339-UTC-Ende mit Z.
period.startTime	Zeichenkette; mindestens 20 Zeichen	Wenn das übergeordnete Objekt angegeben ist	Bei period erforderlich	Gültiger RFC3339-UTC-Beginn mit Z.
uaqiColorPalette / --uaqi-color-palette	Zeichenkette; Werte: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	Nein	Google-Standardpalette	Universelle Palette RED_GREEN, INDIGO_PERSIAN_DARK oder INDIGO_PERSIAN_LIGHT. Lokale Paletten bleiben fest.
universalAqi / --universal-aqi	boolescher Wert	Nein	Google: true	Universellen Luftqualitätsindex einschließen.

Verhalten und Einschränkungen

• Referenz: https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup
• Genau eine Zeitauswahl erforderlich. Syntax, Reihenfolge und Höchstdauer werden lokal geprüft; Google prüft aktuelle Verfügbarkeit und Abdeckung.
• Eine Seite je Aufruf; nextPageToken ausdrücklich folgen. Indizes, Konzentrationen, Empfehlungen und Region bleiben erhalten.
• Attributions-, Anzeige- und Cache-Regeln beachten. Abdeckung und lokale Indizes variieren. https://developers.google.com/maps/documentation/air-quality/policies

Primärquellen: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

Ergebnis

Native Sammlung hoursInfo, regionCode und nextPageToken mit verfügbaren Schadstoffen und Empfehlungen.

Beispiel

MCP-Argumente:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 24,
  "pageSize": 12
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_air_quality_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":24,"pageSize":12}'

maps_air_quality_heatmap

Luftqualitäts-Heatmap-Kachel für einen Index oder Schadstoff herunterladen.

Luftqualitäts-Heatmap-Kachel für einen Index oder Schadstoff herunterladen.

CLI-Befehl: air-quality-heatmap. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
mapType / --map-type	Zeichenkette; Werte: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO, US_AQI	Ja	Erforderlich	Index/Schadstoff: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO oder US_AQI.
x / --x	Ganzzahl; 0–65535	Ja	Erforderlich	Spalte, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
y / --y	Ganzzahl; 0–65535	Ja	Erforderlich	Zeile, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
zoom / --zoom	Ganzzahl; 0–16	Ja	Erforderlich	Web-Mercator-Zoom 0 bis 16; auf Stufe null eine Kachel.

Verhalten und Einschränkungen

• Abdeckung hängt von Land, Index und Saison ab. https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile
• Attribution, Anzeigeregeln und Speicher-/Cache-Grenzen beachten; Header bleiben erhalten, keine Lizenzgewährung. https://developers.google.com/maps/documentation/air-quality/policies

Primärquellen: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

Ergebnis

Kachelbytes mit Google-MIME- und Cache-Metadaten; MCP zeigt das Bild, CLI --output schreibt Bytes.

Beispiel

MCP-Argumente:

{
  "mapType": "UAQI_RED_GREEN",
  "zoom": 2,
  "x": 2,
  "y": 1
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_air_quality_heatmap --args '{"mapType":"UAQI_RED_GREEN","zoom":2,"x":2,"y":1}'

maps_pollen_heatmap

Pollenindex-Kachel für Bäume, Gräser oder Kräuter herunterladen.

Pollenindex-Kachel für Bäume, Gräser oder Kräuter herunterladen.

CLI-Befehl: pollen-heatmap. Google-Zugriff: API-Schlüssel, aktivierte Pollen API und Abrechnung; Dienstkonto-OAuth für Pollen wird hier nicht unterstützt.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
mapType / --map-type	Zeichenkette; Werte: TREE_UPI, GRASS_UPI, WEED_UPI	Ja	Erforderlich	TREE_UPI, GRASS_UPI oder WEED_UPI.
x / --x	Ganzzahl; 0–65535	Ja	Erforderlich	Spalte, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
y / --y	Ganzzahl; 0–65535	Ja	Erforderlich	Zeile, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
zoom / --zoom	Ganzzahl; 0–16	Ja	Erforderlich	Web-Mercator-Zoom 0 bis 16; auf Stufe null eine Kachel.

Verhalten und Einschränkungen

• Abdeckung hängt von Land, Index und Saison ab. https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile
• Attribution, Anzeigeregeln und Speicher-/Cache-Grenzen beachten; Header bleiben erhalten, keine Lizenzgewährung. https://developers.google.com/maps/documentation/pollen/policies

Primärquellen: https://developers.google.com/maps/documentation/pollen/policies, https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

Ergebnis

Kachelbytes mit Google-MIME- und Cache-Metadaten; MCP zeigt das Bild, CLI --output schreibt Bytes.

Beispiel

MCP-Argumente:

{
  "mapType": "TREE_UPI",
  "zoom": 2,
  "x": 2,
  "y": 1
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_pollen_heatmap --args '{"mapType":"TREE_UPI","zoom":2,"x":2,"y":1}'

maps_weather_history

Bis zu 24 vergangene Wetterstunden mit ausdrücklicher Seitennavigation abrufen.

Bis zu 24 vergangene Wetterstunden mit ausdrücklicher Seitennavigation abrufen.

CLI-Befehl: weather-history. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
hours / --hours	Ganzzahl; 1–24	Nein	Google: 24	Vorherige Stunden ab der letzten Stunde, 1 bis 24.
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Google: en	IETF-BCP-47-Antwortsprache, sofern verfügbar.
location / --location	Objekt	Ja	Erforderlich	Ort der angefragten Bedingungen.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Breitengrad in Grad, -90 bis 90.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Längengrad in Grad, -180 bis 180.
pageSize / --page-size	Ganzzahl; 1–24	Nein	Historie: Google 24; sonst Google-Standard	Maximale Datensätze je Seite: Historie 1–24, Warnungen/Minutenprognose hier 1–1000.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Vorheriges nextPageToken; andere Argumente unverändert lassen.
unitsSystem / --units-system	Zeichenkette; Werte: METRIC, IMPERIAL	Nein	Google: METRIC	Einheiten METRIC oder IMPERIAL, insbesondere für Niederschlag.

Verhalten und Einschränkungen

• Nur die letzten 24 Stunden, keine beliebigen vergangenen Daten. https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup
• Wetterabdeckung und Richtlinien beachten; keine automatischen Folgeseiten. https://developers.google.com/maps/documentation/weather/policies

Primärquellen: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

Ergebnis

Native historyHours, timeZone und nextPageToken mit allen Stundenbedingungen.

Beispiel

MCP-Argumente:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 12,
  "pageSize": 6
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_weather_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":12,"pageSize":6}'

maps_weather_alerts

Öffentliche Wetterwarnungen für einen Ort mit nativer Schwere und ausgebender Behörde abrufen.

Öffentliche Wetterwarnungen für einen Ort mit nativer Schwere und ausgebender Behörde abrufen.

CLI-Befehl: weather-alerts. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
languageCode / --language-code	Zeichenkette; mindestens 1 Zeichen	Nein	Google: en	IETF-BCP-47-Antwortsprache, sofern verfügbar.
location / --location	Objekt	Ja	Erforderlich	Ort der angefragten Bedingungen.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Breitengrad in Grad, -90 bis 90.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Längengrad in Grad, -180 bis 180.
pageSize / --page-size	Ganzzahl; 1–1000	Nein	Historie: Google 24; sonst Google-Standard	Maximale Datensätze je Seite: Historie 1–24, Warnungen/Minutenprognose hier 1–1000.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Vorheriges nextPageToken; andere Argumente unverändert lassen.

Verhalten und Einschränkungen

• Abdeckung, Verzögerung und Felder hängen von der ausgebenden Behörde ab. https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup
• Anbieterangaben erhalten. Fehlende Warnungen garantieren keine Sicherheit. https://developers.google.com/maps/documentation/weather/policies

Primärquellen: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

Ergebnis

Native weatherAlerts, Behörden-/Gebietsangaben und verfügbares nextPageToken.

Beispiel

MCP-Argumente:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "pageSize": 5
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_weather_alerts --args '{"location":{"latitude":48.85,"longitude":2.35},"pageSize":5}'

maps_weather_minute_forecast

EXPERIMENTELL: Hochaufgelöste Niederschlagsprognose über sechs Stunden abrufen.

EXPERIMENTELL: Hochaufgelöste Niederschlagsprognose über sechs Stunden abrufen.

CLI-Befehl: weather-minute-forecast. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
location / --location	Objekt	Ja	Erforderlich	Ort der angefragten Bedingungen.
location.latitude	Zahl; -90.0–90.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Breitengrad in Grad, -90 bis 90.
location.longitude	Zahl; -180.0–180.0	Wenn das übergeordnete Objekt angegeben ist	Bei location erforderlich	Längengrad in Grad, -180 bis 180.
pageSize / --page-size	Ganzzahl; 1–1000	Nein	Historie: Google 24; sonst Google-Standard	Maximale Datensätze je Seite: Historie 1–24, Warnungen/Minutenprognose hier 1–1000.
pageToken / --page-token	Zeichenkette; mindestens 1 Zeichen	Nein	Erste Seite	Vorheriges nextPageToken; andere Argumente unverändert lassen.
unitsSystem / --units-system	Zeichenkette; Werte: METRIC, IMPERIAL	Nein	Google: METRIC	Einheiten METRIC oder IMPERIAL, insbesondere für Niederschlag.

Verhalten und Einschränkungen

• Experimentell/Vorabangebot: begrenzter Support und inkompatible Änderungen möglich. https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map
• Attribution erforderlich. Google begrenzt die Zwischenspeicherung dieser Prognosen/Kacheln auf eine Stunde; danach muss der Inhalt gelöscht werden.
• Google untersagt mit diesen Inhalten die Nachbildung eines Google-Diensts/-Produkts, einschließlich primär wetterbezogener Apps oder Modelle. Die Einschränkungen gelten auch für nachgelagerte Nutzer.
• Minutenprognosen und Kacheln können zeitlich abweichen. Eine Seite je Aufruf; Verfügbarkeit nach Ort und Zugang.

Primärquellen: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Ergebnis

Native overallPredictionTimeframe, timeZone, segments und nextPageToken; Typ, Wahrscheinlichkeit, Mengen und Intensität bleiben erhalten.

Beispiel

MCP-Argumente:

{
  "location": {
    "latitude": 37.60451,
    "longitude": -80.59044
  },
  "pageSize": 5
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_weather_minute_forecast --args '{"location":{"latitude":37.60451,"longitude":-80.59044},"pageSize":5}'

maps_weather_map

EXPERIMENTELL: Niederschlags-Nowcast-Kachel für USA oder Europa herunterladen.

EXPERIMENTELL: Niederschlags-Nowcast-Kachel für USA oder Europa herunterladen.

CLI-Befehl: weather-map. Google-Zugriff: API-Schlüssel oder cloud-platform-OAuth 2.0; API und Abrechnung aktivieren. Bei OAuth benötigt die Identität im Kontingentprojekt serviceusage.services.use.

Parameter

Parameter / CLI-Option	Typ und Schema-Grenzen	Erforderlich	Standard bei Auslassung	Beschreibung
mapType / --map-type	Zeichenkette; Werte: US_PRECIPITATION_CURRENT, EU_PRECIPITATION_CURRENT	Ja	Erforderlich	US_PRECIPITATION_CURRENT oder EU_PRECIPITATION_CURRENT je Abdeckungsregion.
x / --x	Ganzzahl; 0–65535	Ja	Erforderlich	Spalte, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
y / --y	Ganzzahl; 0–65535	Ja	Erforderlich	Zeile, 0 bis 2^zoom−1; Grenzen werden vor dem Aufruf geprüft.
zoom / --zoom	Ganzzahl; 0–16	Ja	Erforderlich	Web-Mercator-Zoom 0 bis 16; auf Stufe null eine Kachel.

Verhalten und Einschränkungen

• Experimentell/Vorabangebot: begrenzter Support und inkompatible Änderungen möglich. https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map
• Attribution erforderlich. Google begrenzt die Zwischenspeicherung dieser Prognosen/Kacheln auf eine Stunde; danach muss der Inhalt gelöscht werden.
• Google untersagt mit diesen Inhalten die Nachbildung eines Google-Diensts/-Produkts, einschließlich primär wetterbezogener Apps oder Modelle. Die Einschränkungen gelten auch für nachgelagerte Nutzer.
• USA-/Europa-Abdeckung nur laut Anleitung; gültige Kachelkoordinaten garantieren keine Daten.

Primärquellen: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Ergebnis

Kachelbytes mit Google-MIME- und Cache-Metadaten; MCP zeigt das Bild, CLI --output schreibt Bytes.

Beispiel

MCP-Argumente:

{
  "mapType": "US_PRECIPITATION_CURRENT",
  "zoom": 12,
  "x": 1025,
  "y": 1688
}

Entsprechender CLI-Aufruf:

mcp-gmap-rs call maps_weather_map --args '{"mapType":"US_PRECIPITATION_CURRENT","zoom":12,"x":1025,"y":1688}'