Riferimento strumenti

Tutti i 42 strumenti, con ogni parametro, valore predefinito, vincolo ed esempio. La stessa interfaccia è disponibile tramite MCP e CLI.

Convenzioni di chiamata

Gli esempi sono oggetti di argomenti MCP. Per una chiamata MCP diretta tools/call, usa il nome dello strumento in name e l’oggetto in arguments. L’host può aggiungere un prefisso ai nomi. Le chiamate CLI equivalenti qui sotto usano mcp-gmap-rs call STRUMENTO --args JSON.

Solo i parametri di primo livello hanno un’opzione CLI. Passa oggetti annidati e array in JSON. Un’opzione booleana da sola significa true; --flag false imposta false. Le proprietà sconosciute vengono rifiutate. Consulta la versione installata con tools o schema STRUMENTO.

L’autenticazione Google e la lingua sono configurazioni del processo, non parametri dello strumento. Le coordinate esatte evitano la risoluzione degli indirizzi; i luoghi nominati possono richiedere anche una chiave API per Geocoding. Vedi autenticazione e configurazione.

Le chiamate possono comportare costi Google. I risultati compositi e delle matrici possono contenere errori per elemento anche se lo strumento riesce. Mantieni i link Google, gli autori di recensioni/foto e le diciture dei riepiloghi IA. Gli esempi illustrano gli input, senza garantire risultati o copertura attuali.

Tipi, campi obbligatori e limiti provengono dal riferimento derivato dagli schemi dell’eseguibile. Valori predefiniti, risultati e vincoli tra campi sono verificati nell’implementazione. Google può imporre ulteriori limiti di copertura e quota.

Le proprietà sconosciute al primo livello vengono rifiutate; i corpi API nativi accettano campi Google, validati da Google. Le operazioni di modifica non vengono ritentate automaticamente.

Strumenti

• 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

Converte un indirizzo o un punto di interesse in coordinate.

Risolve un indirizzo o un punto di interesse nel primo risultato Geocoding. Utile per ottenere coordinate riutilizzabili e un place ID; non verifica la possibilità di recapitare posta.

Comando CLI: geocode. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
address / --address	stringa; almeno 1 carattere/i	Sì	—	Indirizzo, città o punto di interesse da geocodificare.

Comportamento e restrizioni

• L’assenza di corrispondenze è un errore dello strumento, non una posizione vuota restituita con successo.
• Questo strumento diretto usa Geocoding v3. Il ripiego su Places appartiene ai compositi che risolvono luoghi, non a questa chiamata.

Risultato

Un oggetto con location.lat, location.lng, formatted_address e place_id. Viene restituito soltanto il primo risultato.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_validate_address

Valida e normalizza un indirizzo postale, restituendo il verdetto Google, correzioni, componenti e geocodifica. Il verdetto è un elemento di valutazione, non una garanzia di consegna.

Valida i componenti postali e restituisce correzioni, indirizzo normalizzato e verdetto Google. Mantieni visibili al chiamante il verdetto e i componenti non risolti.

Comando CLI: validate-address. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
addressLines / --address-lines	array di stringhe; 1–10 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Una o più righe dell’indirizzo postale, in ordine.
administrativeArea / --administrative-area	stringa; almeno 1 carattere/i	No	Non fornito	Stato, provincia o area amministrativa corrispondente.
enableUspsCass / --enable-usps-cass	booleano	No	false	Richiede l’elaborazione USPS CASS; questa implementazione richiede regionCode US oppure PR quando true.
locality / --locality	stringa; almeno 1 carattere/i	No	Non fornito	Città o località.
postalCode / --postal-code	stringa; almeno 1 carattere/i	No	Non fornito	Codice postale o ZIP.
regionCode / --region-code	stringa; modello: ^[A-Z]{2}$	No	Non fornito; Google può dedurlo	Codice paese o regione di due lettere maiuscole; consigliato per disambiguare l’indirizzo.
sessionToken / --session-token	stringa; almeno 1 carattere/i	No	Nessun raggruppamento; fatturazione per richiesta	Token sicuro per URL generato dal chiamante, massimo 36 caratteri ASCII; consigliato un nuovo UUID v4 per sessione. Riutilizzarlo nella chiamata conclusiva Place Details o Address Validation.

Comportamento e restrizioni

• Un verdetto di validazione non garantisce la consegna.
• La copertura geografica e dell’API varia. Questo strumento non invia feedback di validazione e non accetta automaticamente le correzioni.

Risultato

La risposta completa di validazione, normalmente con result.verdict, result.address, result.geocode e responseId; Google può omettere campi non disponibili.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_pollen

Ottiene da 1 a 5 giorni di previsioni polliniche, indici e raccomandazioni sanitarie per coordinate esatte. La copertura dipende da luogo e stagione.

Recupera una breve previsione pollinica giornaliera per coordinate esatte. La risposta conserva tipi di polline, indici, informazioni sulle piante e raccomandazioni del fornitore.

Comando CLI: pollen. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
days / --days	intero; 1–5	No	1	Numero di giorni di previsione da richiedere.
latitude / --latitude	numero; -90.0–90.0	Sì	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
longitude / --longitude	numero; -180.0–180.0	Sì	—	Longitudine WGS84 in gradi decimali; positiva verso est.
plantsDescription / --plants-description	booleano	No	false	Include descrizioni dettagliate delle piante e informazioni correlate quando disponibili.

Comportamento e restrizioni

• Le richieste usano una pagina di 5 elementi, sufficiente per i cinque giorni massimi richiesti da questo strumento; non vengono recuperate altre pagine automaticamente.
• La disponibilità dipende da luogo, stagione e copertura Google.

Risultato

La risposta Pollen originale, inclusi regionCode, dailyInfo ed eventuale nextPageToken. Ogni giorno può includere informazioni su tipi di polline e piante.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_area_insights

Conta i luoghi dentro un cerchio, una regione o un poligono tramite Places Aggregate. Gli identificativi facoltativi sono disponibili solo per conteggi fino a 100; nessuna richiesta automatica di dettagli.

Conta i luoghi corrispondenti in un cerchio, una regione o un poligono tramite Places Aggregate. È una query aggregata, distinta dal conteggio di una pagina limitata di ricerca Places.

Comando CLI: area-insights. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
area / --area	oggetto	Sì	—	Esattamente una tra circle, region e customArea.
area.circle	oggetto	No	Non fornito	Area circolare; mutuamente esclusiva con region e customArea.
area.circle.latLng	oggetto	Se il genitore è presente	—	Centro del cerchio espresso con coordinate esatte.
area.circle.latLng.latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
area.circle.latLng.longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.
area.circle.radius	intero; 23–50000	Se il genitore è presente	—	Raggio del cerchio in metri.
area.customArea	oggetto	No	Non fornito	Area poligonale personalizzata; mutuamente esclusiva con circle e region.
area.customArea.polygon	oggetto	Se il genitore è presente	—	Confine del poligono.
area.customArea.polygon.coordinates	array di oggetti; 4–1000 elementi	Se il genitore è presente	—	Anello ordinato di oggetti coordinate; prima e ultima coordinata devono coincidere.
area.customArea.polygon.coordinates[].latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
area.customArea.polygon.coordinates[].longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.
area.region	oggetto	No	Non fornito	Regione amministrativa o geografica identificata da una risorsa luogo Google.
area.region.place	stringa; modello: ^places/[A-Za-z0-9_-]+$	Se il genitore è presente	—	Risorsa della regione in formato places/PLACE_ID, non un nome di regione libero.
excludedTypes / --excluded-types	array di stringhe; 1–50 elementi; ogni elemento contiene almeno 1 carattere/i	No	Nessun filtro sui tipi esclusi	Tipi di luogo Google da escludere.
includePlaces / --include-places	booleano	No	false	Richiede gli identificativi delle risorse luogo corrispondenti oltre al conteggio.
includedTypes / --included-types	array di stringhe; 1–50 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Tipi di luogo Google da includere, per esempio restaurant o cafe.
maxRating / --max-rating	numero; 1.0–5.0	No	Nessun limite superiore di valutazione	Limite superiore inclusivo della valutazione.
minRating / --min-rating	numero; 1.0–5.0	No	Nessun limite inferiore di valutazione	Limite inferiore inclusivo della valutazione; non può superare maxRating.
operatingStatus / --operating-status	array di stringhe; 1–3 elementi; valori: OPERATING_STATUS_OPERATIONAL, OPERATING_STATUS_PERMANENTLY_CLOSED, OPERATING_STATUS_TEMPORARILY_CLOSED	No	Google usa come valore predefinito i luoghi operativi	Stati operativi consentiti.
priceLevels / --price-levels	array di stringhe; 1–5 elementi; valori: PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE	No	Tutti i livelli di prezzo	Livelli di prezzo consentiti.

Comportamento e restrizioni

• Fornisci esattamente una forma di area. Nella CLI gli oggetti annidati sono valori JSON; i loro parametri figli non hanno opzioni indipendenti.
• Gli anelli dei poligoni devono essere chiusi. Google controlla anche geometria, tipi supportati, superficie e copertura.
• I place ID sono disponibili solo per conteggi fino a 100. Lo strumento non richiede automaticamente Place Details.

Risultato

La risposta Google con count (normalmente una stringa int64) ed eventuali risorse placeInsights[].place quando gli identificativi sono stati richiesti e sono disponibili.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Associa alle strade una traccia GPS ordinata di 2–100 punti. Per buoni risultati mantieni i punti consecutivi entro circa 300 metri. L’interpolazione facoltativa aggiunge geometria stradale.

Associa una traccia GPS ordinata alla geometria stradale più probabile. Usa Nearest Roads per punti indipendenti anziché per un percorso seguito.

Comando CLI: snap-to-roads. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
interpolate / --interpolate	booleano	No	false	Aggiunge geometria stradale intermedia tra i punti forniti.
path / --path	array di oggetti; 2–100 elementi	Sì	—	Oggetti coordinate GPS nell’ordine di percorrenza.
path[].latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
path[].longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Per una buona associazione i punti consecutivi dovrebbero distare al massimo circa 300 metri.
• I punti interpolati possono essere privi di originalIndex. Questo strumento non richiede limiti di velocità.

Risultato

La risposta Roads originale, con snappedPoints ed eventuale warningMessage. I punti conservano placeId stradale, location e originalIndex quando presenti.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Trova i tratti stradali più vicini a 1–100 punti GPS indipendenti; conserva originalIndex di Google e i place ID stradali.

Trova tratti stradali vicini a punti GPS indipendenti senza interpretarli come un’unica traccia continua.

Comando CLI: nearest-roads. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
points / --points	array di oggetti; 1–100 elementi	Sì	—	Oggetti coordinate indipendenti da associare.
points[].latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
points[].longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Un punto può corrispondere a più tratti stradali; conserva originalIndex senza presumere una sola uscita per ogni ingresso.
• Questo strumento non richiede limiti di velocità.

Risultato

La risposta Roads originale con snappedPoints, placeId stradale, location e originalIndex per risalire ai punti di ingresso.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_reverse_geocode

Converte coordinate in un indirizzo stradale.

Converte coordinate esatte nel primo risultato di geocodifica inversa. Usa i componenti del risultato quando il solo indirizzo formattato non basta.

Comando CLI: reverse-geocode. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
latitude / --latitude	numero; -90.0–90.0	Sì	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
longitude / --longitude	numero; -180.0–180.0	Sì	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Viene restituito soltanto il primo risultato. L’assenza di corrispondenze è un errore dello strumento.

Risultato

Il primo risultato Geocoding nativo, inclusi formatted_address, address_components, geometry e place_id quando disponibili.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_search_places

Cerca Places (New) tramite testo con filtri facoltativi di posizione e valutazione.

Cerca Places (New) tramite testo e filtri facoltativi di posizione, valutazione e tipo. Usa gli identificativi restituiti per richiedere selettivamente i dettagli.

Comando CLI: search-places. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
includedType / --included-type	stringa; almeno 1 carattere/i	No	Nessun filtro sul tipo	Tipo di luogo Google, per esempio cafe.
locationBias / --location-bias	oggetto	No	Nessuna preferenza geografica	Preferenza circolare facoltativa di ricerca; non è un vincolo geografico rigido.
locationBias.latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
locationBias.longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.
locationBias.radius	numero; 0.1–50000.0	No	5000	Raggio della preferenza geografica in metri.
minRating / --min-rating	numero; 0.0–5.0	No	Nessun filtro sulla valutazione	Valutazione minima degli utenti richiesta a Google.
openNow / --open-now	booleano	No	Nessuna restrizione sullo stato di apertura	Quando true, limita ai luoghi attualmente aperti.
query / --query	stringa; almeno 1 carattere/i	Sì	—	Ricerca di luoghi in linguaggio naturale.

Comportamento e restrizioni

• Questo strumento richiede una pagina di 20 risultati e non restituisce né segue automaticamente un token di pagina.
• La disponibilità dei dati di apertura e valutazione dipende dalla copertura Google; questa ricerca non va interpretata come un inventario completo.

Risultato

Un array di massimo 20 oggetti Google Place con campi di ricerca selezionati, link Maps o alle fonti e metadati di attribuzione.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_search_nearby

Trova luoghi intorno a un indirizzo o a coordinate esatte, filtrando per tipo, valutazione e stato di apertura.

Trova luoghi entro un raggio delimitato intorno a un centro risolto. A differenza di Text Search, usa un vincolo geografico circolare rigido.

Comando CLI: search-nearby. Accesso Google: Places accetta chiave API oppure OAuth. Un centro espresso come indirizzo o punto di interesse richiede anche una chiave API per la risoluzione Geocoding.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
center / --center	oggetto	Sì	—	Valore del centro e indicatore che ne definisce l’interpretazione.
center.isCoordinates	booleano	No	false	Interpreta value come coordinate esatte senza geocodifica.
center.value	stringa; almeno 1 carattere/i	Se il genitore è presente	—	Indirizzo o punto di interesse, oppure stringa latitude,longitude quando isCoordinates è true.
keyword / --keyword	stringa; almeno 1 carattere/i	No	Nessun filtro sul tipo	Tipo di luogo Google passato come includedTypes, per esempio cafe; non una parola chiave testuale arbitraria.
minRating / --min-rating	numero; 0.0–5.0	No	Nessun filtro sulla valutazione	Valutazione minima applicata localmente ai luoghi restituiti.
openNow / --open-now	booleano	No	false	Mantiene soltanto i risultati con currentOpeningHours.openNow uguale a true.
radius / --radius	numero; 0.1–50000.0	No	1000	Raggio di ricerca in metri.

Comportamento e restrizioni

• Durante il filtraggio, uno stato di apertura mancante non equivale ad aperto e una valutazione mancante viene trattata come 0.
• I centri espressi come indirizzi richiedono una risoluzione della posizione; le coordinate evitano quella chiamata aggiuntiva.

Risultato

Un array di massimo 20 oggetti Place selezionati. I filtri locali di apertura e valutazione possono ridurlo ulteriormente.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_place_details

Ottiene dettagli, recensioni e attribuzioni del luogo. Gli URL delle foto facoltativi conservano l’attribuzione degli autori. Mostra fonti e avvertenze insieme al contenuto.

Approfondisce un place ID noto con dettagli selezionati, recensioni e URL di foto facoltativi. Conserva informazioni su autori e fonti e le eventuali avvertenze AI.

Comando CLI: place-details. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
maxPhotos / --max-photos	intero; 0–10	No	0	Numero massimo di ricerche di URL dei media fotografici.
placeId / --place-id	stringa; almeno 1 carattere/i	Sì	—	Identificativo Google del luogo, facoltativamente preceduto da places/.
sessionToken / --session-token	stringa; almeno 1 carattere/i	No	Nessun raggruppamento; fatturazione per richiesta	Token sicuro per URL generato dal chiamante, massimo 36 caratteri ASCII; consigliato un nuovo UUID v4 per sessione. Riutilizzarlo nella chiamata conclusiva Place Details o Address Validation.

Comportamento e restrizioni

• Ogni foto selezionata può aggiungere una richiesta; zero foto evita queste chiamate.
• Lo strumento usa una maschera fissa di campi di dettaglio, non tutti i possibili campi Google Place. I campi non disponibili possono essere assenti.

Risultato

Un oggetto Google Place nativo relativo alla maschera di campi richiesta. Quando vengono richieste foto, photoUrls contiene URL dei media, attribuzioni degli autori e link alle fonti.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_directions

Ottiene indicazioni, geometria del percorso, istruzioni di navigazione e durata del viaggio.

Calcola un percorso tra due estremi e restituisce sia dati di percorso Google selezionati sia totali normalizzati.

Comando CLI: directions. Accesso Google: Routes e Places accettano chiave API oppure OAuth. La risoluzione di luoghi per nome richiede anche una chiave API per Geocoding; le stringhe di coordinate esatte evitano tale ricerca.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
arrival_time / --arrival-time	stringa; almeno 1 carattere/i	No	Non fornito	Arrivo desiderato in RFC 3339 con fuso orario; soltanto modalità transit.
avoid_highways / --avoid-highways	booleano	No	false	Evita autostrade; true è supportato soltanto con driving.
avoid_tolls / --avoid-tolls	booleano	No	false	Evita strade a pedaggio; true è supportato soltanto con driving.
departure_time / --departure-time	stringa; almeno 1 carattere/i	No	Non fornito	Istante di partenza in RFC 3339, con Z o un offset UTC esplicito.
destination / --destination	stringa; almeno 1 carattere/i	Sì	—	Indirizzo o punto di interesse di destinazione, oppure stringa di coordinate esatte latitude,longitude.
mode / --mode	stringa; valori: driving, walking, bicycling, transit	No	driving	Modalità di viaggio. driving utilizza il traffico nel calcolo del percorso.
origin / --origin	stringa; almeno 1 carattere/i	Sì	—	Indirizzo o punto di interesse di partenza, oppure stringa di coordinate esatte latitude,longitude.
polylineQuality / --polyline-quality	stringa; valori: OVERVIEW, HIGH_QUALITY	No	HIGH_QUALITY con trafficSegments=true; altrimenti Google usa OVERVIEW per impostazione predefinita	Qualità geometrica: OVERVIEW o HIGH_QUALITY. La scelta esplicita ha sempre precedenza, anche OVERVIEW insieme a trafficSegments=true. Controlla la densità dei punti indipendentemente dai calcoli del traffico.
trafficSegments / --traffic-segments	booleano	No	false	Opzione booleana solo per la guida. Richiede TRAFFIC_ON_POLYLINE con geometria ENCODED_POLYLINE; usa HIGH_QUALITY salvo polylineQuality esplicita. Il traffico sulle polilinee attiva lo SKU Compute Routes Enterprise, più costoso; lasciare false se il dettaglio non serve.

Comportamento e restrizioni

• departure_time e arrival_time non possono essere forniti insieme. arrival_time è accettato soltanto con transit.
• Le opzioni per evitare strade richiedono driving. Google applica ulteriori restrizioni di modalità, orario e regione.
• L’assenza di un percorso disponibile produce un errore esplicito.
• Con trafficSegments=true, Routes fornisce intervalli NORMAL, SLOW o TRAFFIC_JAM. I segmenti normalizzati di percorso e tratta usano la rispettiva polilinea, con indici dei punti indipendenti. Gli intervalli Google sono [start,end); la geometria conserva il vertice finale condiviso per coprire l’ultimo arco. La copertura assente o non valida viene segnalata, senza inventare traffico normale.
• segmentMetadata.retrievedAt è l’ora locale di ricezione della risposta, non l’ora di osservazione del traffico del fornitore; trafficObservedAt è null perché Routes non la restituisce. roadCategory e speedLimit sono null perché questa risposta Routes non li fornisce. Nessuna chiamata implicita a Roads né moltiplicatore locale della durata: le durate restano previsioni Google.
• I segmenti di traffico sono facoltativi e limitati alla guida in questo eseguibile. Richiederli attiva le polilinee con traffico e la fatturazione Compute Routes Enterprise. Contratto degli intervalli; attivazione degli SKU attuali.
• polylineQuality seleziona il dettaglio geometrico fornito da Google: HIGH_QUALITY usa più punti, aumenta la risposta e può aumentare la latenza. OVERVIEW esplicito resta valido con trafficSegments=true. Se omesso, i segmenti di traffico usano HIGH_QUALITY; altrimenti Google usa OVERVIEW. Il programma non sintetizza né interpola dettagli aggiuntivi. La qualità è indipendente da extraComputations: HIGH_QUALITY da solo non attiva TRAFFIC_ON_POLYLINE. Definizione ufficiale di PolylineQuality.

Fonti primarie: 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

Risultato

Un oggetto con routes, summary, total_distance (valore in metri), total_duration (valore in secondi) ed eventuali indici di ottimizzazione. Le voci di percorso contengono tratte, passi, polilinea e avvertenze selezionati. Con trafficSegments=true, percorsi e tratte includono anche segments normalizzati e segmentMetadata.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_distance_matrix

Calcola distanze e durate di viaggio per più origini e destinazioni.

Confronta distanza e durata di viaggio per ogni coppia origine/destinazione. Controlla singole celle ed errori senza considerare completa una risposta solo perché riuscita.

Comando CLI: distance-matrix. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
avoid_highways / --avoid-highways	booleano	No	false	Evita autostrade; true è supportato soltanto con driving.
avoid_tolls / --avoid-tolls	booleano	No	false	Evita strade a pedaggio; true è supportato soltanto con driving.
departure_time / --departure-time	stringa; almeno 1 carattere/i	No	Non fornito	Istante di partenza in RFC 3339, con Z o un offset UTC esplicito.
destinations / --destinations	array di stringhe; 1–50 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Stringhe delle destinazioni: indirizzi o coppie esatte latitude,longitude.
mode / --mode	stringa; valori: driving, walking, bicycling, transit	No	driving	Modalità di viaggio. driving utilizza il traffico nel calcolo del percorso.
origins / --origins	array di stringhe; 1–50 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Stringhe delle origini: indirizzi o coppie esatte latitude,longitude.

Comportamento e restrizioni

• Massimo 625 coppie origine × destinazione; transit è limitato a 100 coppie.
• Massimo 50 stringhe origine/destinazione non espresse come coordinate in totale. I limiti di schema dei singoli array non superano questi limiti combinati.
• L’esclusione di pedaggi e autostrade vale soltanto con driving. Questo strumento non espone arrival_time.
• Una singola richiesta HTTP di matrice può comportare la fatturazione di più elementi.

Risultato

Un oggetto con origin_addresses, destination_addresses, matrici per righe distances e durations e un array errors. Le celle riuscite sono espresse in metri e secondi; quelle fallite o mancanti rimangono null.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Ottiene l’altitudine in metri per coordinate geografiche.

Ottiene l’altitudine geografica per punti con coordinate esatte.

Comando CLI: elevation. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
locations / --locations	array di oggetti; 1–512 elementi	Sì	—	Oggetti coordinate per cui richiedere l’altitudine.
locations[].latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
locations[].longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Lo strumento restituisce i dati comunicati da Google senza convertire le unità dell’altitudine.

Risultato

L’array results nativo di Elevation. Le voci possono contenere elevation in metri, location e resolution.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_timezone

Ottiene fuso orario, offset UTC/ora legale e ora locale. timestamp è espresso in millisecondi Unix.

Determina il fuso orario e gli offset UTC e dell’ora legale in un istante, quindi ricava un timestamp locale.

Comando CLI: timezone. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
latitude / --latitude	numero; -90.0–90.0	Sì	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
longitude / --longitude	numero; -180.0–180.0	Sì	—	Longitudine WGS84 in gradi decimali; positiva verso est.
timestamp / --timestamp	intero; 0–253402300799999	No	Ora UTC corrente in millisecondi	Millisecondi dall’epoca Unix, non secondi.

Comportamento e restrizioni

• La richiesta converte i millisecondi in secondi interi; la precisione inferiore al secondo non viene mantenuta.
• L’ora locale usa gli offset base e dell’ora legale restituiti per l’istante richiesto.

Risultato

Campi della risposta Time Zone come timeZoneId, timeZoneName, rawOffset e dstOffset in secondi, più localTime derivato in formato RFC 3339.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_weather

Ottiene meteo corrente, previsioni giornaliere oppure orarie.

Richiede le condizioni correnti o una pagina di previsioni giornaliere o orarie per coordinate esatte.

Comando CLI: weather. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
forecastDays / --forecast-days	intero; 1–10	No	5	Numero di giorni di previsione richiesti; usato soltanto con forecast_daily.
forecastHours / --forecast-hours	intero; 1–240	No	24	Numero di ore di previsione richieste; usato soltanto con forecast_hourly.
latitude / --latitude	numero; -90.0–90.0	Sì	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
longitude / --longitude	numero; -180.0–180.0	Sì	—	Longitudine WGS84 in gradi decimali; positiva verso est.
type / --type	stringa; valori: current, forecast_daily, forecast_hourly	No	current	Seleziona condizioni correnti, previsioni giornaliere oppure orarie.

Comportamento e restrizioni

• forecastDays è ignorato per gli altri tipi; forecastHours è ignorato al di fuori di forecast_hourly.
• Questo strumento non segue automaticamente i token di paginazione. L’orizzonte richiesto può superare i record contenuti in una singola pagina di risposta.
• Copertura e disponibilità delle previsioni dipendono da Google.

Risultato

La risposta Weather nativa: campi delle condizioni correnti, forecastDays oppure forecastHours, in base a type. Conserva unità, timestamp ed eventuale nextPageToken restituiti.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_air_quality

Ottiene indici di qualità dell’aria, concentrazioni facoltative degli inquinanti e raccomandazioni sanitarie.

Ottiene indici correnti di qualità dell’aria con concentrazioni facoltative degli inquinanti e raccomandazioni sanitarie del fornitore.

Comando CLI: air-quality. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
includeHealthRecommendations / --include-health-recommendations	booleano	No	true	Richiede il calcolo Google delle raccomandazioni sanitarie.
includePollutants / --include-pollutants	booleano	No	false	Richiede le concentrazioni degli inquinanti.
latitude / --latitude	numero; -90.0–90.0	Sì	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
longitude / --longitude	numero; -180.0–180.0	Sì	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Le raccomandazioni sono dati del fornitore, non una valutazione sanitaria personalizzata.
• Questo strumento espone condizioni correnti, non endpoint storici o previsionali.

Risultato

La risposta nativa delle condizioni correnti di Air Quality, con indici ed eventuali healthRecommendations e pollutants forniti da Google.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_static_map

Recupera una mappa PNG con indicatori e tracciati. MCP restituisce un’immagine incorporata; la CLI restituisce JSON base64 oppure scrive --output.

Genera una mappa PNG con specifiche facoltative di indicatori e tracciati.

Comando CLI: static-map. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
center / --center	stringa; almeno 1 carattere/i	No	Non fornito	Centro espresso come indirizzo o stringa latitude,longitude.
maptype / --maptype	stringa; valori: roadmap, satellite, terrain, hybrid	No	roadmap	Stile della mappa di base.
markers / --markers	array di stringhe; 1–100 elementi; ogni elemento contiene almeno 1 carattere/i	No	Nessun indicatore	Specifiche ripetute di indicatori Google Static Maps, per esempio color:red|48.8584,2.2945.
path / --path	array di stringhe; 1–100 elementi; ogni elemento contiene almeno 1 carattere/i	No	Nessun tracciato	Specifiche ripetute di tracciati Google Static Maps, per esempio color:blue|48.8584,2.2945|48.8606,2.3376.
size / --size	stringa; modello: ^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$	No	600x400	Dimensioni in pixel WIDTHxHEIGHT; durante l’esecuzione ogni dimensione è limitata a 1–640.
zoom / --zoom	intero; 0–21	No	Omesso; Google lo sceglie o lo deduce	Livello di zoom esplicito.

Comportamento e restrizioni

• È necessario almeno uno tra center, markers e path.
• L’URL completo della richiesta deve rientrare in 16.384 caratteri. Il pattern di size nello schema è più ampio del limite effettivo di 640 pixel applicato durante l’esecuzione.
• Lo stile di indicatori e tracciati segue la sintassi Google Static Maps. L’attribuzione Google rimane nell’immagine generata.

Risultato

MCP restituisce contenuto image/png incorporato. La CLI restituisce JSON {mimeType,base64}, oppure byte PNG grezzi quando viene specificato --output.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Geocodifica fino a 50 indirizzi con successo o errore per ciascuno e concorrenza limitata.

Geocodifica una lista limitata di indirizzi mantenendo l’ordine di ingresso e il successo o fallimento di ogni elemento.

Comando CLI: batch-geocode. Accesso Google: Questa implementazione richiede una chiave API.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
addresses / --addresses	array di stringhe; 1–50 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Stringhe di indirizzi o punti di interesse da risolvere.

Comportamento e restrizioni

• Usa concorrenza limitata con al massimo cinque richieste Google attive per processo.
• Gli errori dei singoli elementi non impongono un codice d’uscita CLI diverso da zero; controlla success ed error in ogni riga.

Risultato

Un array nell’ordine di ingresso. Ogni riga contiene address, success e data (l’oggetto di geocodifica) oppure error.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_explore_area

Risolve una posizione ed esplora categorie con dettagli per i primi risultati. Usa punti di interesse specifici per pianificare un viaggio.

Risolve una posizione, cerca le categorie selezionate nelle vicinanze e approfondisce soltanto i primi risultati di ciascuna categoria.

Comando CLI: explore-area. Accesso Google: Places accetta chiave API oppure OAuth. I luoghi indicati per nome richiedono anche una chiave API per Geocoding.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
location / --location	stringa; almeno 1 carattere/i	Sì	—	Indirizzo o punto di interesse, oppure stringa di coordinate esatte latitude,longitude.
radius / --radius	numero; 0.1–50000.0	No	1000	Raggio di ricerca delle categorie in metri.
topN / --top-n	intero; 1–20	No	3	Numero massimo di luoghi per categoria da approfondire con dettagli.
types / --types	array di stringhe; 1–10 elementi; ogni elemento contiene almeno 1 carattere/i	No	restaurant, cafe, tourist_attraction	Categorie di luoghi Google da cercare.

Comportamento e restrizioni

• Ogni categoria cerca fino a 20 luoghi; count è il numero restituito nella pagina, non un inventario aggregato.
• Gli errori di categoria e dettaglio rimangono visibili in un risultato complessivo riuscito.
• Questo composito effettua più richieste Google; limita categorie e topN al necessario.

Risultato

Un oggetto con location risolta, radius e categories. Ogni categoria contiene type/count/top oppure un errore; i luoghi approfonditi possono contenere details_error.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_plan_route

Pianifica un percorso di 2–27 tappe. Ottimizza 2–25 tappe intermedie, escluso transit. Le coordinate esatte vengono mantenute.

Pianifica un solo percorso attraverso tappe ordinate, chiedendo facoltativamente a Google di riordinare le tappe intermedie mantenendo fissi gli estremi.

Comando CLI: plan-route. Accesso Google: Routes e Places accettano chiave API oppure OAuth. La risoluzione di luoghi per nome richiede anche una chiave API per Geocoding; le stringhe di coordinate esatte evitano tale ricerca.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
avoid_highways / --avoid-highways	booleano	No	false	Evita autostrade; true è supportato soltanto con driving.
avoid_tolls / --avoid-tolls	booleano	No	false	Evita strade a pedaggio; true è supportato soltanto con driving.
departure_time / --departure-time	stringa; almeno 1 carattere/i	No	Non fornito	Istante di partenza in RFC 3339, con Z o un offset UTC esplicito.
mode / --mode	stringa; valori: driving, walking, bicycling, transit	No	driving	Modalità di viaggio. driving utilizza il traffico nel calcolo del percorso.
optimize / --optimize	booleano	No	true, alle condizioni indicate	Richiede l’ottimizzazione delle tappe intermedie quando le tappe totali sono più di tre e mode non è transit.
polylineQuality / --polyline-quality	stringa; valori: OVERVIEW, HIGH_QUALITY	No	HIGH_QUALITY con trafficSegments=true; altrimenti Google usa OVERVIEW per impostazione predefinita	Qualità geometrica: OVERVIEW o HIGH_QUALITY. La scelta esplicita ha sempre precedenza, anche OVERVIEW insieme a trafficSegments=true. Controlla la densità dei punti indipendentemente dai calcoli del traffico.
stops / --stops	array di stringhe; 2–27 elementi; ogni elemento contiene almeno 1 carattere/i	Sì	—	Indirizzi o punti di interesse ordinati, oppure stringhe di coordinate esatte latitude,longitude; primo e ultimo restano gli estremi.
trafficSegments / --traffic-segments	booleano	No	false	Opzione booleana solo per la guida. Richiede TRAFFIC_ON_POLYLINE con geometria ENCODED_POLYLINE; usa HIGH_QUALITY salvo polylineQuality esplicita. Il traffico sulle polilinee attiva lo SKU Compute Routes Enterprise, più costoso; lasciare false se il dettaglio non serve.

Comportamento e restrizioni

• transit supporta soltanto due estremi, senza tappe intermedie.
• L’ottimizzazione diventa effettiva soltanto con almeno quattro tappe totali, cioè almeno due tappe intermedie.
• Ottimizza l’ordine delle tappe di un percorso, non l’assegnazione di veicoli o incarichi a una flotta.
• Con trafficSegments=true, Routes fornisce intervalli NORMAL, SLOW o TRAFFIC_JAM. I segmenti normalizzati di percorso e tratta usano la rispettiva polilinea, con indici dei punti indipendenti. Gli intervalli Google sono [start,end); la geometria conserva il vertice finale condiviso per coprire l’ultimo arco. La copertura assente o non valida viene segnalata, senza inventare traffico normale.
• segmentMetadata.retrievedAt è l’ora locale di ricezione della risposta, non l’ora di osservazione del traffico del fornitore; trafficObservedAt è null perché Routes non la restituisce. roadCategory e speedLimit sono null perché questa risposta Routes non li fornisce. Nessuna chiamata implicita a Roads né moltiplicatore locale della durata: le durate restano previsioni Google.
• I segmenti di traffico sono facoltativi e limitati alla guida in questo eseguibile. Richiederli attiva le polilinee con traffico e la fatturazione Compute Routes Enterprise. Contratto degli intervalli; attivazione degli SKU attuali.
• polylineQuality seleziona il dettaglio geometrico fornito da Google: HIGH_QUALITY usa più punti, aumenta la risposta e può aumentare la latenza. OVERVIEW esplicito resta valido con trafficSegments=true. Se omesso, i segmenti di traffico usano HIGH_QUALITY; altrimenti Google usa OVERVIEW. Il programma non sintetizza né interpola dettagli aggiuntivi. La qualità è indipendente da extraComputations: HIGH_QUALITY da solo non attiva TRAFFIC_ON_POLYLINE. Definizione ufficiale di PolylineQuality.

Fonti primarie: 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

Risultato

Un oggetto con mode, valore effettivo di optimized, stops risolte e ordinate, legs per la visualizzazione, total_distance, total_duration, polyline e warnings. durationSeconds delle tratte è un numero di secondi. Con trafficSegments=true, percorsi e tratte includono anche segments normalizzati e segmentMetadata.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Cerca e confronta luoghi con informazioni dettagliate e distanza in auto facoltativa da userLocation.

Trova e arricchisce una breve lista di luoghi, confrontando facoltativamente la distanza in auto da coordinate utente esatte.

Comando CLI: compare-places. Accesso Google: Places e le chiamate Routes facoltative accettano chiave API oppure OAuth.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
limit / --limit	intero; 1–20	No	5	Numero massimo di luoghi corrispondenti da arricchire.
query / --query	stringa; almeno 1 carattere/i	Sì	—	Query di ricerca testuale Places.
userLocation / --user-location	oggetto	No	Nessun confronto di distanza o tempo	Coordinate utente esatte per il confronto facoltativo delle distanze.
userLocation.latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
userLocation.longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.

Comportamento e restrizioni

• Il confronto dei tragitti usa driving; questo strumento non ha un parametro per configurare la modalità di viaggio.
• Gli errori dei dettagli e delle distanze vengono conservati senza eliminare luoghi altrimenti utilizzabili.
• Viene arricchita soltanto la lista ristretta richiesta.

Risultato

Un oggetto con places ed eventuale distance_error. I luoghi possono includere details/details_error, distance, drive_time e distance_errors per luogo.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Trova luoghi lungo un percorso usando la sua polilinea codificata.

Calcola un percorso e cerca Places usando la sua polilinea codificata, invece di approssimare il viaggio con una singola ricerca circolare.

Comando CLI: search-along-route. Accesso Google: Routes e Places accettano chiave API oppure OAuth. La risoluzione di luoghi per nome richiede anche una chiave API per Geocoding; le stringhe di coordinate esatte evitano tale ricerca.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
destination / --destination	stringa; almeno 1 carattere/i	Sì	—	Indirizzo o punto di interesse di destinazione del percorso, oppure stringa di coordinate esatte latitude,longitude.
maxResults / --max-results	intero; 1–20	No	5	Numero massimo di risultati Places richiesti nella pagina di risposta.
mode / --mode	stringa; valori: driving, walking, bicycling, transit	No	walking	Modalità di viaggio del percorso usato nella ricerca.
origin / --origin	stringa; almeno 1 carattere/i	Sì	—	Indirizzo o punto di interesse di partenza del percorso, oppure stringa di coordinate esatte latitude,longitude.
textQuery / --text-query	stringa; almeno 1 carattere/i	Sì	—	Query Places per soste lungo il percorso, ad esempio caffè o stazioni di ricarica.

Comportamento e restrizioni

• La modalità predefinita è walking, diversamente da directions, matrix e plan-route che usano driving.
• Non esegue paginazione automatica né approfondimenti Place Details.
• Questo strumento non espone i parametri di partenza, arrivo o esclusione strade di directions.

Risultato

Un oggetto con places, eventuali routingSummaries e il route calcolato, con dati di percorso Google selezionati e totali normalizzati.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Misura il posizionamento di ricerca su una griglia geografica per 1–3 parole chiave; restituisce ARP, ATRP, SoLV ed errori per punto.

Misura la comparsa di un luogo obiettivo tra i primi 20 risultati Text Search in ogni punto di una griglia geografica.

Comando CLI: local-rank-tracker. Accesso Google: Chiave API oppure OAuth per l’API principale.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
center / --center	oggetto	Sì	—	Centro esatto della griglia di scansione.
center.latitude	numero; -90.0–90.0	Se il genitore è presente	—	Latitudine WGS84 in gradi decimali; positiva verso nord.
center.longitude	numero; -180.0–180.0	Se il genitore è presente	—	Longitudine WGS84 in gradi decimali; positiva verso est.
gridSize / --grid-size	intero; 3–7	No	3	Numero di righe e colonne; sono accettati tutti gli interi da 3 a 7.
gridSpacing / --grid-spacing	numero; 100.0–10000.0	No	1000	Distanza in metri tra punti adiacenti della griglia.
keyword / --keyword	stringa; almeno 1 carattere/i	No	Non fornito	Singola parola chiave di ricerca; usa keyword oppure keywords.
keywords / --keywords	array di stringhe; 1–3 elementi; ogni elemento contiene almeno 1 carattere/i	No	Non fornito	Da una a tre parole chiave; ha precedenza se entrambe le forme sono fornite.
placeId / --place-id	stringa; almeno 1 carattere/i	Sì	—	Identificativo del luogo obiettivo, facoltativamente preceduto da places/.

Comportamento e restrizioni

• È richiesta almeno una tra keyword e keywords; le singole righe dello schema non esprimono questa alternativa.
• Le richieste di ricerca crescono come numero di parole chiave × gridSize², fino a 147 prima dei retry.
• I punti falliti sono esclusi dalle metriche di posizione, non trattati come assenze valide. Le metriche possono essere null in assenza di osservazioni utilizzabili.
• La posizione di ricerca non è la valutazione nelle recensioni del luogo. I risultati campionano ricerche testuali con preferenza geografica e non garantiscono il posizionamento visto da un utente su Google Maps.

Risultato

Un oggetto con target, grid_size, grid_spacing_m e metriche e griglia per parola chiave. ARP è la media delle posizioni trovate; ATRP usa posizione 21 per le ricerche riuscite in cui il luogo è assente; SoLV è la percentuale di punti riusciti nelle prime 3 posizioni. failed_points e found_in espongono la copertura.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Limiti di velocità con accesso Asset Tracking.

Recupera limiti automobilistici per segmenti da un percorso GPS o ID Roads. Funzione limitata ad Asset Tracking; abilitare Roads non basta.

Comando CLI: speed-limits. Accesso Google: Chiave API richiesta anche in modalità OAuth; abilitare servizio, fatturazione e restrizioni appropriate.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
path / --path	array di oggetti; 1–100 elementi	No	Non fornito	Da 1 a 100 punti GPS; esclude roadPlaceIds. Google adatta il tracciato alla strada prima della ricerca.
path[].latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio per ogni punto	Latitudine WGS84 in gradi, da -90 a 90.
path[].longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio per ogni punto	Longitudine WGS84 in gradi, da -180 a 180.
roadPlaceIds / --road-place-ids	array di stringhe; 1–100 elementi; ogni elemento contiene almeno 1 carattere/i	No	Non fornito	Da 1 a 100 ID di segmenti dagli strumenti Roads; gli ID delle attività normali possono non avere dati. Esclude path.
units / --units	stringa; valori: KPH, MPH	No	KPH	Unità: KPH per km/h o MPH per miglia/ora.

Comportamento e restrizioni

• Google richiede una licenza Asset Tracking; progetti Premium migrati con tale capacità possono mantenerla. Fatturazione ordinaria o API attiva non provano l’accesso. Ogni voce speedLimits è fatturata: una richiesta può includere più addebiti; usare batch minimi.
• Per limiti variabili si restituisce il massimo automobilistico. Dati non in tempo reale, talvolta assenti, stimati o obsoleti: seguire segnaletica e requisiti di sicurezza. Il 403 conserva la causa Google depurata e un suggerimento; può dipendere anche da API, chiave o permessi, non sempre dalla licenza.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/roads/speed-limits

Fonti primarie: https://developers.google.com/maps/documentation/roads/speed-limits

Risultato

Risposta Roads completa: speedLimits con placeId, speedLimit, units, eventuali snappedPoints del tracciato, avvisi e metadati.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_autocomplete

Suggerisce luoghi e indirizzi durante la digitazione.

Suggerimenti Places API New durante la digitazione, con luoghi/query, preferenze o restrizioni geografiche, filtri, cursore e sessioni di fatturazione gestite dal chiamante.

Comando CLI: autocomplete. Accesso Google: Chiave API oppure OAuth Places con ambito Places/cloud-platform.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
includeFutureOpeningBusinesses / --include-future-opening-businesses	booleano	No	false	Include attività che apriranno in futuro.
includePureServiceAreaBusinesses / --include-pure-service-area-businesses	booleano	No	false	Include attività che visitano o servono i clienti senza sede pubblica.
includeQueryPredictions / --include-query-predictions	booleano	No	false	Include suggerimenti di query oltre ai luoghi.
includedPrimaryTypes / --included-primary-types	array di stringhe; 0–5 elementi; ogni elemento contiene almeno 1 carattere/i	No	Tutti i tipi	Fino a cinque tipi primari; (cities) o (regions), se usato, deve essere l’unico valore.
includedRegionCodes / --included-region-codes	array di stringhe; 0–15 elementi	No	Tutte le regioni	Fino a 15 codici CLDR di due lettere; si intersecano con locationRestriction. Un array vuoto non limita i risultati.
input / --input	stringa; almeno 1 carattere/i	Sì	—	Testo non vuoto, anche nome di luogo o indirizzo parziale.
inputOffset / --input-offset	intero; 0–4294967295	No	Fine del testo	Posizione del cursore da zero in caratteri Unicode; non supera la lunghezza di input.
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Valore configurato di GOOGLE_MAPS_LANGUAGE	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
locationBias / --location-bias	oggetto	No	Preferenza Google basata su IP senza opzioni geografiche	Preferenza attorno a un solo cerchio o rettangolo; i risultati possono uscirne. Esclude locationRestriction.
locationBias.circle	oggetto	No	Non fornito	Area circolare; esclude rectangle.
locationBias.circle.center	oggetto	Se il genitore è presente	Obbligatorio con circle	Centro WGS84 del cerchio.
locationBias.circle.center.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il centro	Latitudine WGS84 in gradi, da -90 a 90.
locationBias.circle.center.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il centro	Longitudine WGS84 in gradi, da -180 a 180.
locationBias.circle.radius	numero; 0.0–50000.0	Se il genitore è presente	Obbligatorio con circle	Raggio in metri, massimo 50000; positivo per locationRestriction.
locationBias.rectangle	oggetto	No	Non fornito	Rettangolo chiuso, esclude circle; le longitudini possono attraversare l’antimeridiano.
locationBias.rectangle.high	oggetto	Se il genitore è presente	Obbligatorio con rectangle	Limite nord-est; la latitudine non è inferiore a low.latitude.
locationBias.rectangle.high.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il limite	Latitudine WGS84 in gradi, da -90 a 90.
locationBias.rectangle.high.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il limite	Longitudine WGS84 in gradi, da -180 a 180.
locationBias.rectangle.low	oggetto	Se il genitore è presente	Obbligatorio con rectangle	Limite sud-ovest; la latitudine non supera high.latitude.
locationBias.rectangle.low.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il limite	Latitudine WGS84 in gradi, da -90 a 90.
locationBias.rectangle.low.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il limite	Longitudine WGS84 in gradi, da -180 a 180.
locationRestriction / --location-restriction	oggetto	No	Preferenza Google basata su IP senza opzioni geografiche	Limita a un solo cerchio o rettangolo; esclude locationBias.
locationRestriction.circle	oggetto	No	Non fornito	Area circolare; esclude rectangle.
locationRestriction.circle.center	oggetto	Se il genitore è presente	Obbligatorio con circle	Centro WGS84 del cerchio.
locationRestriction.circle.center.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il centro	Latitudine WGS84 in gradi, da -90 a 90.
locationRestriction.circle.center.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il centro	Longitudine WGS84 in gradi, da -180 a 180.
locationRestriction.circle.radius	numero; 0.0–50000.0	Se il genitore è presente	Obbligatorio con circle	Raggio in metri, massimo 50000; positivo per locationRestriction.
locationRestriction.rectangle	oggetto	No	Non fornito	Rettangolo chiuso, esclude circle; le longitudini possono attraversare l’antimeridiano.
locationRestriction.rectangle.high	oggetto	Se il genitore è presente	Obbligatorio con rectangle	Limite nord-est; la latitudine non è inferiore a low.latitude.
locationRestriction.rectangle.high.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il limite	Latitudine WGS84 in gradi, da -90 a 90.
locationRestriction.rectangle.high.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il limite	Longitudine WGS84 in gradi, da -180 a 180.
locationRestriction.rectangle.low	oggetto	Se il genitore è presente	Obbligatorio con rectangle	Limite sud-ovest; la latitudine non supera high.latitude.
locationRestriction.rectangle.low.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con il limite	Latitudine WGS84 in gradi, da -90 a 90.
locationRestriction.rectangle.low.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con il limite	Longitudine WGS84 in gradi, da -180 a 180.
origin / --origin	oggetto	No	Distanza omessa	Coordinate di riferimento per la distanza geodetica distanceMeters.
origin.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con origin	Latitudine WGS84 in gradi, da -90 a 90.
origin.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con origin	Longitudine WGS84 in gradi, da -180 a 180.
regionCode / --region-code	stringa; modello: ^[A-Za-z]{2}$	No	Non fornito	Codice regione CLDR di due lettere per formato e ordinamento; non limita i risultati alla regione.
sessionToken / --session-token	stringa; almeno 1 carattere/i; modello: ^[A-Za-z0-9_-]+$	No	Nessun raggruppamento; fatturazione per richiesta	Token sicuro per URL generato dal chiamante, massimo 36 caratteri ASCII; consigliato un nuovo UUID v4 per sessione. Riutilizzarlo nella chiamata conclusiva Place Details o Address Validation.

Comportamento e restrizioni

• Lo strumento non crea né conclude sessioni automaticamente. Stesso progetto Google Cloud per tutta la sessione, conclusa con Place Details o Address Validation idoneo. Nuovo token per la sessione successiva; assenza o riuso può causare fatturazione per richiesta.
• Raggio massimo 50000 m, positivo nelle restrizioni. Latitudini del rettangolo ordinate; longitudini possono attraversare l’antimeridiano. Conservare attribuzione Google Maps/fornitori; termini EEA e campi possono differire.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

Fonti primarie: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

Risultato

Risposta suggestions completa: placePrediction/queryPrediction, corrispondenze del testo, formattazione, ID, distanceMeters opzionale e metadati; nessuna maschera elimina campi.

Esempio

Argomenti MCP:

{
  "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
}

Chiamata CLI equivalente:

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

Stima la posizione da celle e Wi-Fi.

Stima la posizione del dispositivo da celle o access point Wi-Fi con il corpo Geolocation nativo completo.

Comando CLI: geolocate. Accesso Google: Chiave API richiesta anche in modalità OAuth; abilitare servizio, fatturazione e restrizioni appropriate.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
body / --body	oggetto	Sì	—	Oggetto Geolocation nativo: homeMobileCountryCode, homeMobileNetworkCode, radioType gsm/cdma/wcdma/lte/nr, carrier, considerIp, cellTowers e wifiAccessPoints. Supporta cellId/newRadioCellId e segnale. Un oggetto vuoto permette il ripiego sull’IP del server; Google convalida i campi interni.

Comportamento e restrizioni

• considerIp è true per default. Senza osservazioni radio valide, il ripiego localizza l’IP di uscita del server, non la persona; impostare body.considerIp=false per impedirlo.
• Wi-Fi richiede almeno due access point fissi fisicamente distinti. Google esclude MAC locali e riservati; hotspot mobili e osservazioni non valide possono fallire. Google convalida i dettagli del protocollo; il wrapper rifiuta parametri esterni sconosciuti. Stima approssimata, possibile NOT_FOUND: controllare accuracy.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

Fonti primarie: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

Risultato

location.lat, location.lng e accuracy (raggio di incertezza in metri), con ulteriori campi Google.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Dati degli edifici e livelli solari.

Usa i tre metodi Solar principali: edificio vicino, metadati raster regionali e download GeoTIFF limitati tramite ID.

Comando CLI: solar. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
additionalInsights / --additional-insights	array di stringhe; 0–1 elementi; valori: DETECTED_ARRAYS	No	Nessuna informazione aggiuntiva	DETECTED_ARRAYS facoltativo per building_insights, per i pannelli già presenti sui tetti.
exactQualityRequired / --exact-quality-required	booleano	No	false	Richiede la qualità esatta invece di accettarne una superiore, per dati edificio e livelli.
experiments / --experiments	array di stringhe; 0–1 elementi; valori: EXPANDED_COVERAGE	No	Nessun esperimento	Esperimento facoltativo EXPANDED_COVERAGE per edificio e livelli; classificato pre-GA da Google.
id / --id	stringa; almeno 1 carattere/i	No	— per geo_tiff	ID opaco dall’argomento id di un URL Solar; richiesto solo per geo_tiff. Inviare l’ID, non l’URL.
location / --location	oggetto	No	Non fornito	Coordinate del fabbricato o centro delle mappe; obbligatorie per building_insights/data_layers.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio con location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio con location	Longitudine WGS84 in gradi, da -180 a 180.
operation / --operation	stringa; valori: building_insights, data_layers, geo_tiff	Sì	—	building_insights, data_layers o geo_tiff; accetta solo parametri dell’operazione scelta.
pixelSizeMeters / --pixel-size-meters	numero; valori: 0.1, 0.25, 0.5, 1.0	No	0.1	Dimensione minima del pixel: 0.1, 0.25, 0.5 o 1 metro; alcuni livelli hanno risoluzione nativa inferiore.
radiusMeters / --radius-meters	numero; senza limite–1000	No	Non fornito	Raggio positivo data_layers, massimo 1000 m. Oltre 100 non supera pixelSizeMeters×1000; oltre 175 serve una vista senza flussi mensili o ombra oraria.
requiredQuality / --required-quality	stringa; valori: HIGH, MEDIUM, BASE	No	HIGH (predefinito Google)	Qualità minima HIGH, MEDIUM o BASE; BASE usa immagini satellitari migliorate. Disponibilità variabile.
view / --view	stringa; valori: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS, FULL_LAYERS	No	FULL_LAYERS (predefinito Google)	Livelli: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS o FULL_LAYERS.

Comportamento e restrizioni

• Copertura e qualità variano; NOT_FOUND se manca un edificio entro circa 50 m. URL temporanei e protetti: copiare solo id in geo_tiff, che scarica da solar.googleapis.com/v1/geoTiff:get senza URL arbitrari.
• Risposta massima 16 MiB, budget richieste e scadenza; raster grandi richiedono raggio minore o pixel più grossi. Decodifica e progettazione impianti escluse. EXPANDED_COVERAGE pre-GA; in EEA termini e contenuti possono differire. Fatturazione e quote distinte per endpoint; conservare attribuzione Google Maps.
• Riferimenti ufficiali e limiti: 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

Fonti primarie: 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

Risultato

building_insights/data_layers restituiscono JSON completo con date, qualità, potenziale e URL temporanei senza credenziali. geo_tiff restituisce byte limitati con MIME reale e cache; JSON CLI usa base64.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

URL e metadati dei video Aerial View.

Recupera URL temporanei o metadati di un video Aerial View esistente senza scaricarlo.

Comando CLI: aerial-view. Accesso Google: Chiave API richiesta anche in modalità OAuth; abilitare servizio, fatturazione e restrizioni appropriate.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
address / --address	stringa; almeno 1 carattere/i	No	Non fornito	Indirizzo postale statunitense supportato; esattamente uno tra address e videoId.
operation / --operation	stringa; valori: lookup, metadata	No	lookup	lookup restituisce URL e metadati (a pagamento); metadata solo dati senza URL (metodo Google gratuito).
videoId / --video-id	stringa; almeno 1 carattere/i	No	Non fornito	ID Aerial View già restituito; esclude address.

Comportamento e restrizioni

• Solo indirizzi USA supportati e coperti in 3D. Video mancante: NOT_FOUND; richiedere maps_render_aerial_video. Controllare lo stato con metadata gratuito a intervalli ragionevoli; usare lookup fatturato solo per riprodurre.
• URL a breve scadenza: aggiornarli a ogni visualizzazione. Google vieta download, archiviazione e cache dei video; lo strumento restituisce solo URL. ID conservabili secondo l’eccezione documentata. Attribuzione visibile durante la riproduzione; termini e funzionalità EEA variabili.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/aerial-view/lookup-video ; https://developers.google.com/maps/documentation/aerial-view/policies"]

Fonti primarie: https://developers.google.com/maps/documentation/aerial-view/lookup-video, https://developers.google.com/maps/documentation/aerial-view/policies

Risultato

Risposta Google nativa con stato e metadati, e URL per formato/risoluzione quando attivo. metadata esclude gli URL di riproduzione.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_render_aerial_video

Richiede esplicitamente un rendering aereo.

Accoda esplicitamente un rendering Aerial View asincrono per un indirizzo USA supportato, separato dalla lettura perché l’agente riconosca la modifica.

Comando CLI: render-aerial-video. Accesso Google: Chiave API richiesta anche in modalità OAuth; abilitare servizio, fatturazione e restrizioni appropriate.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
address / --address	stringa; almeno 1 carattere/i	Sì	—	Indirizzo postale statunitense supportato da renderizzare.

Comportamento e restrizioni

• Modifica la coda Google. Nessun tentativo automatico dopo errori transitori, attesa o download. Verificare con maps_aerial_view metadata usando indirizzo o videoId; lookup solo per gli URL.
• Copertura USA/3D, quote e termini del servizio; API attiva non garantisce il rendering. Vietati download, conservazione e cache dei video; mostrare URL aggiornati con attribuzione.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

Fonti primarie: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

Risultato

Risposta nativa con stato e metadati; PROCESSING indica coda o elaborazione, un video esistente può dare subito ACTIVE.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_map_tiles

Tessere 2D, 3D e Street View per la visualizzazione.

Crea sessioni Map Tiles e recupera risorse 2D, 3D e Street View per un visualizzatore, che non è incluso. Licenza Google solo per visualizzazione: vietati interpretazione automatica, analisi immagini, identificazione oggetti, estrazione geodati e uso offline.

Comando CLI: map-tiles. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
east / --east	numero; -180.0–180.0	No	Non fornito; obbligatorio per le operazioni indicate	Longitudine est richiesta; negativa con west positivo permette attraversamento dell’antimeridiano.
fov / --fov	numero; 30.0–120.0	No	90	Campo visivo orizzontale miniatura, 30–120 gradi.
height / --height	intero; 16–250	No	250	Altezza miniatura, 16–250 pixel.
latitude / --latitude	numero; -90.0–90.0	No	Non fornito; obbligatorio per le operazioni indicate	Latitudine WGS84 in gradi, da -90 a 90.
locations / --locations	array di oggetti; 1–100 elementi	No	Non fornito; obbligatorio per le operazioni indicate	Da uno a 100 luoghi per streetview_pano_ids, ciascuno con lat e lng.
locations[].lat	numero; -90.0–90.0	Se il genitore è presente	Non fornito; obbligatorio per le operazioni indicate	Latitudine WGS84 in gradi, da -90 a 90.
locations[].lng	numero; -180.0–180.0	Se il genitore è presente	Non fornito; obbligatorio per le operazioni indicate	Longitudine WGS84 in gradi, da -180 a 180.
longitude / --longitude	numero; -180.0–180.0	No	Non fornito; obbligatorio per le operazioni indicate	Longitudine WGS84 in gradi, da -180 a 180.
north / --north	numero; -90.0–90.0	No	Non fornito; obbligatorio per le operazioni indicate	Latitudine nord richiesta per viewport; deve superare south.
operation / --operation	stringa; valori: create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail, streetview_tile	Sì	—	create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail o streetview_tile; determina endpoint e argomenti richiesti.
panoId / --pano-id	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Richiesto per tessera o miniatura Street View, oppure alternativo alle coordinate nei metadati. Non affidarsi all’ID oltre una sessione.
pitch / --pitch	numero; -90.0–90.0	No	0	Angolo verticale della fotocamera da -90 a 90 gradi.
radius / --radius	numero; 0.0–100000.0	No	50 metri	Raggio Street View in metri, 0–100000, per pano_ids o metadata con coordinate; esclude panoId.
resourceUrl / --resource-url	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Per resource_3d: URL Google assoluto https://tile.googleapis.com/v1/3dtiles/... dal tileset; vietati altri host, porte personalizzate, credenziali, frammenti e percorsi codificati. La chiave dell’URL è rimossa; si usano le credenziali configurate.
session / --session	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Token createSession; richiesto per 2D e Street View, non per 3D. Rispettare expiry della risposta.
sessionOptions / --session-options	oggetto	No	Non fornito; obbligatorio per le operazioni indicate	Opzioni createSession native; mapType, language e region richiesti per create_session.
sessionOptions.highDpi	booleano	No	false	Aumenta i pixel con scala 2x o 4x; nessun effetto con 1x.
sessionOptions.imageFormat	stringa; valori: jpeg, png	No	Google sceglie il formato migliore	Formato jpeg o png; JPEG non supporta sovrapposizioni trasparenti.
sessionOptions.language	stringa; almeno 1 carattere/i	Se il genitore è presente	Non fornito; obbligatorio per le operazioni indicate	Lingua IETF, per esempio en-US.
sessionOptions.layerTypes	array di stringhe; 1–3 elementi; valori: layerRoadmap, layerStreetview, layerTraffic	No	Nessun livello aggiuntivo	Da uno a tre livelli: layerRoadmap, layerStreetview, layerTraffic. terrain richiede layerRoadmap.
sessionOptions.mapType	stringa; valori: roadmap, satellite, terrain, streetview	Se il genitore è presente	Non fornito; obbligatorio per le operazioni indicate	roadmap, satellite, terrain o streetview; terrain richiede layerRoadmap in layerTypes.
sessionOptions.overlay	booleano	No	false	Con true visualizza layerTypes senza immagine di base.
sessionOptions.region	stringa; modello: ^[A-Z]{2}$	Se il genitore è presente	Non fornito; obbligatorio per le operazioni indicate	Codice CLDR di due maiuscole, come US, per la posizione fisica dell’utente.
sessionOptions.scale	stringa; valori: scaleFactor1x, scaleFactor2x, scaleFactor4x	No	scaleFactor1x	Dimensione degli elementi: scaleFactor1x, scaleFactor2x o scaleFactor4x.
sessionOptions.styles	array di oggetti; 1–100 elementi	No	Stile predefinito Google	Oggetti di stile Google nativi, solo per roadmap; sintassi nel riferimento Google.
south / --south	numero; -90.0–90.0	No	Non fornito; obbligatorio per le operazioni indicate	Latitudine sud richiesta per viewport.
west / --west	numero; -180.0–180.0	No	Non fornito; obbligatorio per le operazioni indicate	Longitudine ovest richiesta per viewport.
width / --width	intero; 16–600	No	600	Larghezza miniatura, 16–600 pixel.
x / --x	intero; 0–4194303	No	Non fornito; obbligatorio per le operazioni indicate	Colonna; in 2D inferiore a 2^zoom. Per Street View dipende dalle dimensioni del panorama nei metadati.
y / --y	intero; 0–4194303	No	Non fornito; obbligatorio per le operazioni indicate	Riga; in 2D inferiore a 2^zoom. Per Street View dipende dalle dimensioni del panorama nei metadati.
yaw / --yaw	numero; -360.0–360.0	No	0	Orientamento orizzontale miniatura da -360 a 360 gradi.
zoom / --zoom	intero; 0–22	No	Non fornito; obbligatorio per le operazioni indicate	Zoom intero: 0–22 per tile_2d/viewport, 0–5 per streetview_tile. Verificare disponibilità con viewport.

Comportamento e restrizioni

• create_session richiede sessionOptions; tile_2d session/zoom/x/y; viewport session/zoom/north/south/east/west; root_3d nessun altro campo; resource_3d resourceUrl; pano_ids session/locations; metadata session e panorama o coordinate; thumbnail session/panoId; streetview_tile session/panoId/zoom/x/y. Campi non utilizzati rifiutati.
• Nessun tentativo automatico per creazione sessione; ricerca panorami POST di sola lettura. Il visualizzatore deve unire e renderizzare i dati. Nessuna cache tessere, download massivo, mappa offline o analisi. Non inviare immagini a modelli visivi per interpretazione o estrazione.
• L’accordo limita prefetch, indicizzazione e archiviazione; rispettare Cache-Control ed ETag. Mostrare logo Google Maps e attribuzioni. Usare copyright viewport per 2D, copyright e segnalazioni Street View, crediti in 3D; non tagliare i riconoscimenti. Copertura, costi, quote e termini EEA variabili. Rispettare expiry; ID panorami temporanei.
• Riferimenti ufficiali e limiti: 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 ; https://tile.googleapis.com/v1/3dtiles/

Fonti primarie: 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

Risultato

JSON nativo per sessioni, viewport, panorami e tileset 3D, con attribuzione, copyright, segnalazioni e scadenza. Immagini e risorse 3D non JSON: byte con MIME, Cache-Control ed ETag. MCP mostra immagini supportate, altri dati in base64; CLI --output scrive byte.

Esempio

Argomenti MCP:

{
  "operation": "root_3d"
}

Chiamata CLI equivalente:

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

maps_streetview

Metadati Street View e immagine JPEG.

Verifica metadati panoramici o recupera un JPEG statico per luogo o ID. I metadati permettono di controllare la disponibilità prima dell’immagine fatturata.

Comando CLI: streetview. Accesso Google: Chiave API richiesta per Street View Static; OAuth da solo non basta. Abilitare Street View Static API. Firma digitale consigliata e obbligatoria per alcuni account.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
fov / --fov	numero; 1.0–120.0	No	90	Campo visivo orizzontale immagine, 1–120 gradi.
heading / --heading	numero; 0.0–360.0	No	Google orienta verso il luogo indicato	Orientamento della fotocamera da 0 a 360 gradi.
height / --height	intero; 1–640	No	400	Altezza immagine 1–640 pixel, solo per image.
location / --location	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Indirizzo, coordinate testuali come 48.8584,2.2945 o place_id:PLACE_ID; esattamente uno tra location e panoId.
operation / --operation	stringa; valori: metadata, image	Sì	—	metadata per JSON o image per byte JPEG.
panoId / --pano-id	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	ID di panorama Street View; può cambiare e non va considerato permanente.
pitch / --pitch	numero; -90.0–90.0	No	0	Angolo verticale della fotocamera da -90 a 90 gradi.
radius / --radius	intero; 0–100000	No	50	Raggio di ricerca in metri; l’implementazione accetta interi 0–100000.
returnErrorCode / --return-error-code	booleano	No	true in questa implementazione	Per image: errore HTTP al posto dell’immagine grigia quando mancano immagini.
signature / --signature	stringa; almeno 1 carattere/i	No	Non fornito	Firma URL facoltativa per la richiesta codificata esatta; Google la consiglia e talvolta la richiede. Lo strumento la inoltra senza generarla. Nelle richieste firmate signature viene aggiunto per ultimo, dopo la chiave API. Firma il percorso e la query codificati esatti, inclusi i valori predefiniti generati. Ordine immagine: location, radius, source, pano, size, heading, fov, pitch, return_error_code, key; i campi opzionali assenti vengono omessi. I metadati omettono i campi immagine. Gli spazi diventano +. Predefiniti: size=640x400 e return_error_code=true.
source / --source	stringa; valori: default, google, outdoor	No	default	Sorgente default, google o outdoor; disponibilità secondo raccolta e regione.
width / --width	intero; 1–640	No	640	Larghezza immagine 1–640 pixel, solo per image. Formati speciali più grandi non implementati.

Comportamento e restrizioni

• Esattamente location o panoId. Dimensioni, heading, fov, pitch e returnErrorCode solo per immagini; campi inutilizzati rifiutati. Metadati attualmente gratuiti e senza consumo quota immagini; immagini fatturate.
• Conservare l’attribuzione incorporata. Street View vietato per stampa; limiti Maps sulla conservazione. Il tool non autorizza archiviazione, redistribuzione o analisi. Firma solo inoltrata, non generata; formati speciali esclusi. Copertura e termini EEA variabili; ID e date possono cambiare o mancare.
• Riferimenti ufficiali e limiti: https://about.google/brand-resource-center/products-and-services/geo-guidelines/ ; 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

Fonti primarie: 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

Risultato

JSON metadata nativo con status, date, location, pano_id e copyright se disponibili, oppure byte JPEG con MIME e intestazioni cache sicure. Immagine assente: errore predefinito. CLI --output salva i byte; MCP espone immagine e metadati.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_streetview_publish

Gestisce e pubblica le foto Street View dell’utente.

Gestisce foto e sequenze dell’utente consenziente. Supporta tutti i metodi REST v1 documentati e upload limitato. Pubblicazione e cancellazione esplicite, senza tentativi automatici.

Comando CLI: streetview-publish. Accesso Google: Solo OAuth utente finale con consenso a https://www.googleapis.com/auth/streetviewpublish. Credenziali authorized_user esplicite in GOOGLE_APPLICATION_CREDENTIALS e modalità OAuth. Rifiutati account di servizio, ADC implicito o sola chiave API. Consenso OAuth configurato esternamente; l’eseguibile rinnova credenziali ma non ospita callback browser.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
dataBase64 / --data-base64	stringa; almeno 4 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Media in base64 standard con padding. Dimensione decodificata da 1 byte a 8 MiB; limite dell’implementazione, non di Google.
filter / --filter	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Filtro nativo Google; la sintassi dipende dall’endpoint.
inputType / --input-type	stringa; valori: VIDEO, XDM	No	Non fornito; obbligatorio per le operazioni indicate	Richiesto per create_sequence: VIDEO o XDM.
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Predefinito Google	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
mimeType / --mime-type	stringa; valori: image/jpeg, application/octet-stream, video/mp4	No	image/jpeg	Tipo dei media caricati: image/jpeg, video/mp4 o application/octet-stream.
operation / --operation	stringa; valori: 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	Sì	—	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. Pubblicazione, aggiornamento e cancellazione modificano contenuti pubblici dell’utente.
pageSize / --page-size	intero; 1–100	No	Predefinito del servizio Google	Dimensione pagina 1–100 per list o list_sequences; Google può restituirne meno.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
photo / --photo	oggetto	No	Non fornito; obbligatorio per le operazioni indicate	Oggetto Photo nativo per create/update. Creazione: uploadReference.uploadUrl dopo il caricamento; aggiornamento: photoId e updateMask. Consultare lo schema Photo ufficiale.
photoId / --photo-id	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	ID Google della foto per get/update/delete, senza percorsi o parametri URL.
photoIds / --photo-ids	array di stringhe; 1–100 elementi; ogni elemento contiene almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	Da uno a 100 ID foto per batch_get o batch_delete.
photoSequence / --photo-sequence	oggetto	No	Non fornito; obbligatorio per le operazioni indicate	Oggetto PhotoSequence nativo per create_sequence; richiede uploadReference.uploadUrl e metadati GPS/CAMM/IMU e acquisizione appropriati.
sequenceId / --sequence-id	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	ID sequenza per get_sequence/delete_sequence; deriva dal nome dell’operazione creata.
updateMask / --update-mask	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	FieldMask Google obbligatoria per update, separata da virgole, come pose.heading o pose.latLngPair.
updatePhotoRequests / --update-photo-requests	array di oggetti; 1–100 elementi	No	Non fornito; obbligatorio per le operazioni indicate	Da 1 a 100 UpdatePhotoRequest nativi per batch_update; ciascuno richiede photo.photoId.id e updateMask.
uploadUrl / --upload-url	stringa; almeno 1 carattere/i	No	Non fornito; obbligatorio per le operazioni indicate	URL UploadRef esatto da start_upload/start_sequence_upload, HTTPS su streetviewpublish.googleapis.com, percorso /media/user/{account}/photo/{reference} o photoSequence; vietati redirect, altri host, credenziali, frammenti e percorsi codificati.
view / --view	stringa; valori: BASIC, INCLUDE_DOWNLOAD_URL	No	BASIC	BASIC o INCLUDE_DOWNLOAD_URL per list/get/batch_get/get_sequence. Gli URL di download sono sensibili e non vengono scaricati.

Comportamento e restrizioni

• Flusso foto: start_upload, upload effettivo, create con photo.uploadReference.uploadUrl e metadati. Upload solo non pubblica. Servono immagini 360, metadati Photo Sphere/XMP e criteri Google. Update usa PUT e updateMask; Google non supporta modifica pixel. Delete rimuove foto pubbliche. Doctor e controlli live non scrivono.
• Flusso sequenze: start_sequence_upload, upload, create_sequence con inputType e photoSequence, poi get_sequence. Limite 8 MiB dell’implementazione: video grandi richiedono upload esterno Google; si può usare l’UploadRef risultante. Niente caricamento a blocchi o riprendibile.
• Corpi nativi per GPS, pose, IMU, connessioni e luoghi; Google convalida i dettagli. Il wrapper rifiuta parametri esterni sconosciuti e controlla i requisiti; ogni update batch richiede photo.photoId.id e updateMask. Tutti i metodi REST implementati non significa ogni campo provato dal vivo.
• Upload limitato a origine fissa, POST senza tentativi automatici; tutte le modifiche disabilitano retry per evitare duplicati dopo errori ambigui. Verificare i risultati. Valgono proprietà, privacy, copyright, criteri 360, elaborazione e quote. Account di servizio non sostituisce consenso utente. Nessun test live di pubblicazione con la chiave di servizio fornita: occorre utente consenziente; scritture pubbliche escluse dai controlli.
• Riferimenti ufficiali e limiti: 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 ; https://www.googleapis.com/auth/streetviewpublish

Fonti primarie: 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

Risultato

Photo, elenchi, UploadRef, risultati batch o Operation nativi. Risposte vuote di upload/delete diventano {}. Stato e proprietà conservati. Sequenze possono restare in elaborazione: controllare get_sequence. Nessun polling o pubblicazione automatici.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_datasets

Gestisce dataset cartografici.

Gestisce dataset geospaziali per lo stile basato sui dati di Google Maps, con importazione asincrona da oggetti Cloud Storage esistenti.

Comando CLI: datasets. Accesso Google: Solo OAuth2 con account di servizio o ADC e ambito https://www.googleapis.com/auth/cloud-platform; chiavi API non accettate. Configurare separatamente progetto risorsa e permessi quota.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
dataset / --dataset	oggetto	No	Obbligatorio per create/update	Oggetto Dataset nativo per create/update. Creazione: displayName univoco e usage:["USAGE_DATA_DRIVEN_STYLING"]. L’aggiornamento inserisce il nome risorsa coerente.
gcsSource / --gcs-source	oggetto	No	Obbligatorio per import	Sorgente Cloud Storage esistente da importare; occorre accesso. Nessuna lettura di file locali.
gcsSource.fileFormat	stringa; valori: FILE_FORMAT_GEOJSON, FILE_FORMAT_KML, FILE_FORMAT_CSV	Se il genitore è presente	Obbligatorio quando viene fornito gcsSource	Formato sorgente FILE_FORMAT_GEOJSON, FILE_FORMAT_KML o FILE_FORMAT_CSV.
gcsSource.inputUri	stringa; almeno 1 carattere/i	Se il genitore è presente	Obbligatorio quando viene fornito gcsSource	URI esistente gs://bucket/object; serve storage.objects.get, ad esempio Storage Object Viewer.
name / --name	stringa; modello: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$	No	Obbligatorio per operazioni sulla risorsa	projects/{project}/datasets/{dataset}; richiesto tranne list/create. Solo get accetta @active per l’ultima versione completata.
operation / --operation	stringa; valori: list, get, create, update, delete, import, download, fetch_errors	Sì	Obbligatorio	Scegliere list/get/create/update/delete/import/download/fetch_errors; create/update/delete/import modificano risorse cloud.
pageSize / --page-size	intero; 1–500	No	list: 100; fetch_errors: predefinito Google 50	Numero massimo di dataset o errori per pagina; limite del wrapper 1–500.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
parent / --parent	stringa; modello: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$	No	Obbligatorio per list/create	projects/{project}; obbligatorio per list/create.
tag / --tag	stringa; valori: active	No	Ultima versione indipendentemente dallo stato	Per list: active seleziona l’ultima versione completata ed esclude i dataset che ne sono privi.
updateMask / --update-mask	stringa; almeno 1 carattere/i	No	Google usa * (sostituzione completa dei metadati)	Campi dei metadati separati da virgole, come description,displayName; omissione significa sostituzione completa.
versionDescription / --version-description	stringa; almeno 1 carattere/i	No	Omesso	Descrizione della nuova versione; solo per import.

Comportamento e restrizioni

• Servono permessi mapsplatformdatasets.datasets.list/get/create/update/delete/import/export secondo l’operazione. L’import GCS crea una versione asincrona; controllare get e fetch_errors. Nessun polling automatico.
• La v1 pubblica non documenta listVersions: usare get, @active e versionId; nessuna enumerazione completa dello storico. Download richiede export; CLI --output salva i byte.
• Maps Datasets API non ha costi d’uso, ma richiede un progetto configurato; Google Maps e Cloud Storage possono avere costi e termini propri. Uso supportato: stile basato sui dati. Niente upload locale multipart: usare un oggetto GCS esistente.
• Riferimenti ufficiali e limiti: 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 ; https://www.googleapis.com/auth/cloud-platform

Fonti primarie: 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

Risultato

JSON Dataset, elenco o errori nativi, nome versione importata oppure byte sorgenti con MIME e intestazioni cache. get conserva status.state, status.errorMessage e versionId; importazione avviata non significa elaborazione completata.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_route_optimization

Ottimizza gli itinerari della flotta.

Ottimizza flotte di consegna o assistenza con Route Optimization API e ShipmentModel nativo completo, comprese capacità, finestre temporali e costi.

Comando CLI: route-optimization. Accesso Google: Solo OAuth2 con account di servizio o ADC e ambito https://www.googleapis.com/auth/cloud-platform; chiavi API non accettate. Configurare separatamente progetto risorsa e permessi quota.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
name / --name	stringa; modello: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$	No	Obbligatorio per get_operation	Nome esatto projects/{project}[/locations/{location}]/operations/{ID} restituito da Google; solo per get_operation.
operation / --operation	stringa; valori: optimize, validate, batch, optimize_long_running, optimize_uri, get_operation	Sì	Obbligatorio	optimize risolve sincronicamente; validate usa VALIDATE_ONLY; batch crea un job GCS; optimize_long_running e optimize_uri sono sperimentali; get_operation legge lo stato.
parent / --parent	stringa; modello: ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$	No	Obbligatorio tranne per get_operation	projects/{project}, opzionalmente /locations/-. Ottimizzazione sincrona e lunga rifiutano regioni specifiche; batch/URI accettano il formato nativo.
request / --request	oggetto	No	Obbligatorio tranne per get_operation	Richiesta Google completa senza parent. Soluzione e convalida richiedono model con spedizioni, veicoli e vincoli. Batch: 1–100 modelConfigs con sorgente e destinazione GCS e JSON/PROTO_TEXT. URI: input.uri/output.uri gs:// terminanti .json o .txtpb.

Comportamento e restrizioni

• validate chiama Google con VALIDATE_ONLY senza risolvere il modello. Abilitare il servizio; roles/routeoptimization.viewer permette ottimizzazione e lettura operazioni, editor anche batch. Permessi inclusi: locations.use e operations.create/get.
• I job batch leggono e scrivono GCS con permessi espliciti e possono continuare dopo la richiesta. Nessun upload o polling automatico. Le varianti lunghe e URI sono sperimentali; endpoint sensibile alle maiuscole :OptimizeToursUri. Google non supporta attualmente annullamento, eliminazione o elenco operazioni: solo get_operation.
• Fatturazione per spedizioni e SKU Single Vehicle Routing o Fleet Routing. Servizio distinto dall’ottimizzazione tappe Routes API; un timeout di trasporto non annulla il job.
• Riferimenti ufficiali e limiti: 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 ; https://www.googleapis.com/auth/cloud-platform

Fonti primarie: 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

Risultato

OptimizeToursResponse o Operation nativi; la lettura conserva done:false, metadati e response/error finali senza nascondere gli errori.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Previsioni orarie della qualità dell’aria.

Recupera previsioni orarie per un istante o intervallo esplicito, fino a 96 ore.

Comando CLI: air-quality-forecast. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
customLocalAqis / --custom-local-aqis	array di oggetti; 1–250 elementi	No	Google sceglie gli indici locali	Sostituisce l’indice locale per paesi o regioni specifici.
customLocalAqis[].aqi	stringa; almeno 1 carattere/i	Se il genitore è presente	Obbligatorio per ogni sostituzione	Codice di indice locale supportato, per esempio us_epa; Google verifica la combinazione.
customLocalAqis[].regionCode	stringa; modello: ^[A-Za-z]{2}$	Se il genitore è presente	Obbligatorio per ogni sostituzione	Codice paese o regione di due lettere per la sostituzione.
dateTime / --date-time	stringa; almeno 20 carattere/i	No	Scegliere un selettore temporale	Istante UTC RFC3339 terminante in Z; Google arrotonda all’ora precedente. Esclude period e hours.
extraComputations / --extra-computations	array di stringhe; 1–5 elementi; valori: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	No	Nessun calcolo aggiuntivo	Calcoli aggiuntivi: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION e POLLUTANT_CONCENTRATION.
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Google: en	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
location / --location	oggetto	Sì	Obbligatorio	Coordinate del luogo richiesto; i campi interni sono obbligatori.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Longitudine WGS84 in gradi, da -180 a 180.
pageSize / --page-size	intero; 1–96	No	Google: previsione 24; storico 72	Numero di record orari: massimo 96 per previsione e 168 per storico.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
period / --period	oggetto	No	Scegliere un selettore temporale	Intervallo orario inclusivo ordinato: massimo 96 ore di previsione o 720 di storico. Esclude dateTime e hours.
period.endTime	stringa; almeno 20 carattere/i	Se il genitore è presente	Obbligatorio quando viene fornito period	Fine inclusiva dell’intervallo RFC3339 UTC terminante in Z.
period.startTime	stringa; almeno 20 carattere/i	Se il genitore è presente	Obbligatorio quando viene fornito period	Inizio dell’intervallo RFC3339 UTC terminante in Z.
uaqiColorPalette / --uaqi-color-palette	stringa; valori: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	No	Tavolozza predefinita Google	Tavolozza UAQI: RED_GREEN, INDIGO_PERSIAN_DARK o INDIGO_PERSIAN_LIGHT. Gli indici locali hanno colori fissi.
universalAqi / --universal-aqi	booleano	No	Google: true	Include l’indice universale della qualità dell’aria.

Comportamento e restrizioni

• Scegliere esattamente un selettore temporale; sintassi, ordine e durata sono verificati localmente, disponibilità e copertura da Google. Una pagina per chiamata: seguire nextPageToken esplicitamente. Indici, concentrazioni e consigli conservati. Applicare politiche Air Quality su attribuzione, visualizzazione e cache; copertura variabile per paese.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

Fonti primarie: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

Risultato

hourlyForecasts, regionCode e nextPageToken nativi, con eventuali dati su inquinanti e salute.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

Storico qualità dell’aria fino a 30 giorni.

Recupera lo storico della qualità dell’aria degli ultimi 30 giorni.

Comando CLI: air-quality-history. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
customLocalAqis / --custom-local-aqis	array di oggetti; 1–250 elementi	No	Google sceglie gli indici locali	Sostituisce l’indice locale per paesi o regioni specifici.
customLocalAqis[].aqi	stringa; almeno 1 carattere/i	Se il genitore è presente	Obbligatorio per ogni sostituzione	Codice di indice locale supportato, per esempio us_epa; Google verifica la combinazione.
customLocalAqis[].regionCode	stringa; modello: ^[A-Za-z]{2}$	Se il genitore è presente	Obbligatorio per ogni sostituzione	Codice paese o regione di due lettere per la sostituzione.
dateTime / --date-time	stringa; almeno 20 carattere/i	No	Scegliere un selettore temporale	Istante UTC RFC3339 terminante in Z; Google arrotonda all’ora precedente. Esclude period e hours.
extraComputations / --extra-computations	array di stringhe; 1–5 elementi; valori: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	No	Nessun calcolo aggiuntivo	Calcoli aggiuntivi: LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION e POLLUTANT_CONCENTRATION.
hours / --hours	intero; 1–720	No	Scegliere esattamente uno fra hours/dateTime/period	Numero di ore precedenti, 1–720 (30 giorni); esclude dateTime e period.
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Google: en	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
location / --location	oggetto	Sì	Obbligatorio	Coordinate del luogo richiesto; i campi interni sono obbligatori.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Longitudine WGS84 in gradi, da -180 a 180.
pageSize / --page-size	intero; 1–168	No	Google: previsione 24; storico 72	Numero di record orari: massimo 96 per previsione e 168 per storico.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
period / --period	oggetto	No	Scegliere un selettore temporale	Intervallo orario inclusivo ordinato: massimo 96 ore di previsione o 720 di storico. Esclude dateTime e hours.
period.endTime	stringa; almeno 20 carattere/i	Se il genitore è presente	Obbligatorio quando viene fornito period	Fine inclusiva dell’intervallo RFC3339 UTC terminante in Z.
period.startTime	stringa; almeno 20 carattere/i	Se il genitore è presente	Obbligatorio quando viene fornito period	Inizio dell’intervallo RFC3339 UTC terminante in Z.
uaqiColorPalette / --uaqi-color-palette	stringa; valori: RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	No	Tavolozza predefinita Google	Tavolozza UAQI: RED_GREEN, INDIGO_PERSIAN_DARK o INDIGO_PERSIAN_LIGHT. Gli indici locali hanno colori fissi.
universalAqi / --universal-aqi	booleano	No	Google: true	Include l’indice universale della qualità dell’aria.

Comportamento e restrizioni

• Scegliere esattamente un selettore temporale; sintassi, ordine e durata sono verificati localmente, disponibilità e copertura da Google. Una pagina per chiamata: seguire nextPageToken esplicitamente. Indici, concentrazioni e consigli conservati. Applicare politiche Air Quality su attribuzione, visualizzazione e cache; copertura variabile per paese.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

Fonti primarie: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

Risultato

hoursInfo, regionCode e nextPageToken nativi, con eventuali dati su inquinanti e salute.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_air_quality_heatmap

Tessere della mappa qualità dell’aria.

Scarica una tessera reale della mappa di un indice o inquinante.

Comando CLI: air-quality-heatmap. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
mapType / --map-type	stringa; valori: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO, US_AQI	Sì	Obbligatorio	Tipo indice: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO o US_AQI.
x / --x	intero; 0–65535	Sì	Obbligatorio	Colonna della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
y / --y	intero; 0–65535	Sì	Obbligatorio	Riga della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
zoom / --zoom	intero; 0–16	Sì	Obbligatorio	Livello Web Mercator da 0 a 16; il livello zero contiene una sola tessera.

Comportamento e restrizioni

• Disponibilità secondo indice e paese. Le politiche Air Quality impongono attribuzione e limiti a conservazione e visualizzazione; preservare le intestazioni cache. Il wrapper non concede licenze.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/air-quality/policies ; https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

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

Risultato

Byte della tessera con MIME e intestazioni cache originali; MCP mostra un’immagine e CLI --output salva i byte.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_pollen_heatmap

Tessere delle mappe pollini.

Scarica una tessera PNG reale dell’indice pollini di alberi, graminacee o infestanti.

Comando CLI: pollen-heatmap. Accesso Google: Chiave API richiesta anche in modalità OAuth; abilitare servizio, fatturazione e restrizioni appropriate.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
mapType / --map-type	stringa; valori: TREE_UPI, GRASS_UPI, WEED_UPI	Sì	Obbligatorio	Indice pollini TREE_UPI, GRASS_UPI o WEED_UPI.
x / --x	intero; 0–65535	Sì	Obbligatorio	Colonna della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
y / --y	intero; 0–65535	Sì	Obbligatorio	Riga della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
zoom / --zoom	intero; 0–16	Sì	Obbligatorio	Livello Web Mercator da 0 a 16; il livello zero contiene una sola tessera.

Comportamento e restrizioni

• Disponibilità per paesi supportati e stagione. Le politiche Pollen regolano attribuzione, visualizzazione su Google Maps e cache; abilitare l’API non elimina i limiti della licenza.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/pollen/policies ; https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

Fonti primarie: https://developers.google.com/maps/documentation/pollen/policies, https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

Risultato

Byte della tessera con MIME e intestazioni cache originali; MCP mostra un’immagine e CLI --output salva i byte.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_weather_history

Storico orario del meteo del giorno precedente.

Recupera fino a 24 ore precedenti di meteo con paginazione esplicita.

Comando CLI: weather-history. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
hours / --hours	intero; 1–24	No	Google: 24	Ore precedenti a partire dall’ultima ora, da 1 a 24.
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Google: en	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
location / --location	oggetto	Sì	Obbligatorio	Coordinate del luogo richiesto; i campi interni sono obbligatori.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Longitudine WGS84 in gradi, da -180 a 180.
pageSize / --page-size	intero; 1–24	No	Storico: Google 24; altri: predefinito Google	Record massimi per pagina: 1–24 per storico, 1–1000 per allerte e previsione al minuto.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
unitsSystem / --units-system	stringa; valori: METRIC, IMPERIAL	No	Google: METRIC	Sistema di unità METRIC o IMPERIAL.

Comportamento e restrizioni

• Copre solo le 24 ore precedenti, non date storiche arbitrarie. Si applicano politiche Weather e copertura; nessuna pagina aggiuntiva automatica.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

Fonti primarie: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

Risultato

historyHours, timeZone e nextPageToken nativi, con tutte le condizioni orarie.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_weather_alerts

Allerte meteo pubbliche locali.

Recupera allerte meteo applicabili a un luogo, conservando gravità e autorità emittente.

Comando CLI: weather-alerts. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
languageCode / --language-code	stringa; almeno 1 carattere/i	No	Google: en	Lingua IETF BCP-47 per il testo disponibile; Google può scegliere la lingua supportata più vicina.
location / --location	oggetto	Sì	Obbligatorio	Coordinate del luogo richiesto; i campi interni sono obbligatori.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Longitudine WGS84 in gradi, da -180 a 180.
pageSize / --page-size	intero; 1–1000	No	Storico: Google 24; altri: predefinito Google	Record massimi per pagina: 1–24 per storico, 1–1000 per allerte e previsione al minuto.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.

Comportamento e restrizioni

• Copertura, ritardi e campi dipendono dall’autorità. Conservare l’attribuzione e rispettare le politiche Weather; l’assenza di allerte non garantisce sicurezza.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/weather/policies ; https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

Fonti primarie: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

Risultato

weatherAlerts nativi, dettagli di autorità e area e nextPageToken se disponibile.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_weather_minute_forecast

Previsioni precipitazioni al minuto, sperimentali.

SPERIMENTALE: previsioni di precipitazioni ad alta risoluzione su sei ore.

Comando CLI: weather-minute-forecast. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
location / --location	oggetto	Sì	Obbligatorio	Coordinate del luogo richiesto; i campi interni sono obbligatori.
location.latitude	numero; -90.0–90.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Latitudine WGS84 in gradi, da -90 a 90.
location.longitude	numero; -180.0–180.0	Se il genitore è presente	Obbligatorio quando viene fornito location	Longitudine WGS84 in gradi, da -180 a 180.
pageSize / --page-size	intero; 1–1000	No	Storico: Google 24; altri: predefinito Google	Record massimi per pagina: 1–24 per storico, 1–1000 per allerte e previsione al minuto.
pageToken / --page-token	stringa; almeno 1 carattere/i	No	Prima pagina	Token della pagina successiva dalla risposta precedente; mantenere invariati gli altri parametri. Nessuna paginazione automatica.
unitsSystem / --units-system	stringa; valori: METRIC, IMPERIAL	No	Google: METRIC	Sistema di unità METRIC o IMPERIAL.

Comportamento e restrizioni

• Sperimentale pre-GA: supporto limitato e possibili modifiche incompatibili. Attribuzione obbligatoria; cache di previsioni al minuto e mappe limitata a un’ora, poi cancellare. Google vieta di ricreare suoi prodotti o servizi, inclusi app o modelli dedicati principalmente alle informazioni meteo. Le restrizioni valgono anche a valle.
• Previsione al minuto e tessere possono non essere sincronizzate. Una pagina per chiamata; disponibilità secondo luogo e accesso.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

Fonti primarie: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Risultato

overallPredictionTimeframe, timeZone, segments e nextPageToken; segmenti con tipo, probabilità, quantità e intensità.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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

maps_weather_map

Mappa precipitazioni attuali, sperimentale.

SPERIMENTALE: scarica una tessera di precipitazioni attuali per Stati Uniti o Europa.

Comando CLI: weather-map. Accesso Google: Chiave API o token OAuth2 con ambito cloud-platform; abilitare API e fatturazione. Il principale del progetto quota richiede serviceusage.services.use.

Parametri

Parametro / opzione CLI	Tipo e limiti dello schema	Obbligatorio	Valore se omesso	Descrizione
mapType / --map-type	stringa; valori: US_PRECIPITATION_CURRENT, EU_PRECIPITATION_CURRENT	Sì	Obbligatorio	US_PRECIPITATION_CURRENT o EU_PRECIPITATION_CURRENT; copertura geografica limitata.
x / --x	intero; 0–65535	Sì	Obbligatorio	Colonna della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
y / --y	intero; 0–65535	Sì	Obbligatorio	Riga della tessera da 0 a 2^zoom−1; controllo prima della chiamata.
zoom / --zoom	intero; 0–16	Sì	Obbligatorio	Livello Web Mercator da 0 a 16; il livello zero contiene una sola tessera.

Comportamento e restrizioni

• Sperimentale pre-GA: supporto limitato e possibili modifiche incompatibili. Attribuzione obbligatoria; cache di previsioni al minuto e mappe limitata a un’ora, poi cancellare. Google vieta di ricreare suoi prodotti o servizi, inclusi app o modelli dedicati principalmente alle informazioni meteo. Le restrizioni valgono anche a valle.
• Copertura limitata alle aree USA/Europa della guida Google. Coordinate valide non garantiscono dati per quel luogo.
• Riferimenti ufficiali e limiti: https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map

Fonti primarie: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Risultato

Byte della tessera con MIME e intestazioni cache originali; MCP mostra un’immagine e CLI --output salva i byte.

Esempio

Argomenti MCP:

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

Chiamata CLI equivalente:

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