Referencia de herramientas

Las 42 herramientas, con cada parámetro, valor predeterminado, restricción y ejemplo. La misma interfaz está disponible mediante MCP y CLI.

Convenciones de llamada

Los ejemplos son objetos de argumentos MCP. Para una llamada directa MCP tools/call, use el nombre de herramienta en name y el objeto en arguments. El host puede anteponer un prefijo a los nombres. Las llamadas CLI equivalentes usan mcp-gmap-rs call TOOL --args JSON.

Solo los parámetros de primer nivel tienen opciones CLI. Pase objetos anidados y arrays como JSON. Una opción booleana sin valor significa true; --flag false establece false. Se rechazan las propiedades desconocidas. Examine su versión instalada con tools o schema TOOL.

La autenticación Google y el idioma se configuran por proceso, no como parámetros de herramienta. Las coordenadas exactas evitan resolver direcciones; los lugares con nombre pueden necesitar además una clave API de Geocoding. Consulte autenticación y configuración.

Las llamadas pueden generar cargos Google. Los resultados compuestos y matriciales pueden contener errores por elemento aunque la herramienta termine correctamente. Conserve enlaces Google, autores de reseñas/fotos y avisos de resúmenes IA. Los ejemplos ilustran entradas, no garantizan resultados o cobertura actuales.

Los tipos, campos obligatorios y límites proceden de la referencia derivada de esquemas del ejecutable. Los valores predeterminados, resultados y restricciones entre campos se revisan contra la implementación. Google puede imponer más límites de cobertura y cuota.

Se rechazan las propiedades desconocidas del primer nivel; los cuerpos nativos de la API admiten campos de Google, que valida Google. Las operaciones de modificación no se reintentan automáticamente.

Herramientas

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

Convertir una dirección o lugar de interés en coordenadas.

Resolver una dirección o lugar de interés al primer resultado Geocoding. Obtiene coordenadas reutilizables y un ID de lugar, sin validar la entrega postal.

Comando CLI: geocode. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`address` / `--address`	cadena; al menos 1 carácter(es)	Sí	—	Dirección, ciudad o lugar de interés que geocodificar.

Comportamiento y restricciones

No encontrar coincidencias es un error de herramienta, no una ubicación vacía correcta.
Esta herramienta directa usa Geocoding v3; la alternativa Places se usa en compuestos que resuelven ubicaciones, no en esta llamada.

Resultado

Objeto con location.lat, location.lng, formatted_address y place_id. Solo se devuelve el primer resultado.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_validate_address

Validar y normalizar una dirección postal; devuelve el veredicto Google, correcciones, componentes y geocodificación. El veredicto es evidencia, no garantía de entrega.

Validar componentes postales y devolver correcciones, dirección normalizada y veredicto Google. Mantenga visibles el veredicto y los componentes sin resolver.

Comando CLI: validate-address. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`addressLines` / `--address-lines`	array de cadenas; 1–10 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Una o más líneas de dirección postal, en orden.
`administrativeArea` / `--administrative-area`	cadena; al menos 1 carácter(es)	No	No se proporciona	Estado, provincia o división administrativa equivalente.
`enableUspsCass` / `--enable-usps-cass`	booleano	No	false	Solicitar procesamiento USPS CASS; con true esta implementación exige regionCode US o PR.
`locality` / `--locality`	cadena; al menos 1 carácter(es)	No	No se proporciona	Ciudad o localidad.
`postalCode` / `--postal-code`	cadena; al menos 1 carácter(es)	No	No se proporciona	Código postal/ZIP.
`regionCode` / `--region-code`	cadena; patrón: `^[A-Z]{2}$`	No	No se proporciona; Google puede inferirlo	Código de país/región de dos letras mayúsculas; recomendable para desambiguar la dirección.
`sessionToken` / `--session-token`	cadena; al menos 1 carácter(es)	No	Sin token; Google factura fuera de una sesión Autocomplete	Token Autocomplete (New) del mismo proyecto. Reutilice el token de predicción en esta solicitud final y cree otro para la siguiente sesión.

Comportamiento y restricciones

Un veredicto de validación no garantiza la entrega.
La cobertura regional/API varía. La herramienta no envía comentarios de validación ni acepta correcciones automáticamente.

Resultado

Respuesta de validación completa, normalmente con result.verdict, result.address, result.geocode y responseId; Google puede omitir campos no disponibles.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_pollen

Obtener previsiones de polen, índices y recomendaciones para 1–5 días en coordenadas exactas. La cobertura varía por lugar y estación.

Obtener una previsión diaria breve de polen para coordenadas exactas. Se conservan tipos de polen, índices, información de plantas y recomendaciones del proveedor.

Comando CLI: pollen. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`days` / `--days`	entero; 1–5	No	1	Número de registros diarios de previsión solicitados.
`latitude` / `--latitude`	número; -90.0–90.0	Sí	—	Latitud WGS84 en grados decimales; norte es positivo.
`longitude` / `--longitude`	número; -180.0–180.0	Sí	—	Longitud WGS84 en grados decimales; este es positivo.
`plantsDescription` / `--plants-description`	booleano	No	false	Incluir descripciones detalladas de plantas e información relacionada cuando exista.

Comportamiento y restricciones

Se usa un tamaño de página de 5, suficiente para el máximo de cinco días; no se solicitan páginas adicionales automáticamente.
La disponibilidad depende del lugar, la estación y la cobertura Google.

Resultado

Respuesta Pollen original, con regionCode, dailyInfo y cualquier nextPageToken. Cada día puede incluir información de polen y plantas.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_area_insights

Contar lugares en círculo, región o polígono con Places Aggregate. IDs opcionales solo con 100 resultados o menos; sin consulta automática de detalles.

Contar lugares coincidentes en un círculo, región o polígono con Places Aggregate. Es una consulta agregada, no el recuento de una página limitada de búsqueda Places.

Comando CLI: area-insights. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`area` / `--area`	objeto	Sí	—	Exactamente una de circle, region o customArea.
`area.circle`	objeto	No	No se proporciona	Área circular; excluye region/customArea.
`area.circle.latLng`	objeto	Si se proporciona el objeto padre	—	Centro del círculo como coordenadas exactas.
`area.circle.latLng.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`area.circle.latLng.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.
`area.circle.radius`	entero; 23–50000	Si se proporciona el objeto padre	—	Radio del círculo en metros.
`area.customArea`	objeto	No	No se proporciona	Área poligonal personalizada; excluye circle/region.
`area.customArea.polygon`	objeto	Si se proporciona el objeto padre	—	Límite del polígono.
`area.customArea.polygon.coordinates`	array de objetos; 4–1000 elementos	Si se proporciona el objeto padre	—	Anillo ordenado de objetos de coordenadas; la primera y última deben coincidir.
`area.customArea.polygon.coordinates[].latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`area.customArea.polygon.coordinates[].longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.
`area.region`	objeto	No	No se proporciona	Región administrativa/geográfica identificada por un recurso de lugar Google.
`area.region.place`	cadena; patrón: `^places/[A-Za-z0-9_-]+$`	Si se proporciona el objeto padre	—	Recurso de región con formato places/PLACE_ID, no un nombre de región libre.
`excludedTypes` / `--excluded-types`	array de cadenas; 1–50 elementos; cada elemento al menos 1 carácter(es)	No	Sin filtro de tipos excluidos	Tipos de lugar Google que excluir.
`includePlaces` / `--include-places`	booleano	No	false	Solicitar IDs de recursos de lugares coincidentes además del recuento.
`includedTypes` / `--included-types`	array de cadenas; 1–50 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Tipos de lugar Google que incluir, como restaurant o cafe.
`maxRating` / `--max-rating`	número; 1.0–5.0	No	Sin límite superior de valoración	Límite superior inclusivo de valoración.
`minRating` / `--min-rating`	número; 1.0–5.0	No	Sin límite inferior de valoración	Límite inferior inclusivo de valoración; no puede superar maxRating.
`operatingStatus` / `--operating-status`	array de cadenas; 1–3 elementos; valores: `OPERATING_STATUS_OPERATIONAL`, `OPERATING_STATUS_PERMANENTLY_CLOSED`, `OPERATING_STATUS_TEMPORARILY_CLOSED`	No	Google usa por defecto lugares operativos	Estados operativos permitidos.
`priceLevels` / `--price-levels`	array de cadenas; 1–5 elementos; valores: `PRICE_LEVEL_FREE`, `PRICE_LEVEL_INEXPENSIVE`, `PRICE_LEVEL_MODERATE`, `PRICE_LEVEL_EXPENSIVE`, `PRICE_LEVEL_VERY_EXPENSIVE`	No	Todos los niveles de precio	Niveles de precio permitidos.

Comportamiento y restricciones

Proporcione exactamente una forma de área. Los objetos anidados se pasan como JSON en CLI; sus campos no tienen opciones independientes.
Los anillos del polígono deben cerrarse. Google también comprueba geometría, tipos admitidos, superficie y cobertura.
Los IDs solo están disponibles para recuentos de 100 o menos. No se consulta Place Details automáticamente.

Resultado

Respuesta Google con count (normalmente cadena int64) y recursos opcionales placeInsights[].place si se solicitaron IDs y están disponibles.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Ajustar un recorrido GPS ordenado de 2–100 puntos a carreteras. Mantenga puntos consecutivos a unos 300 metros como máximo. La interpolación opcional añade geometría.

Ajustar un recorrido GPS ordenado a la geometría de carretera más probable. Use Nearest Roads para puntos independientes en lugar de un recorrido.

Comando CLI: snap-to-roads. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`interpolate` / `--interpolate`	booleano	No	false	Añadir geometría intermedia de carretera entre los puntos proporcionados.
`path` / `--path`	array de objetos; 2–100 elementos	Sí	—	Objetos de coordenadas GPS en orden de recorrido.
`path[].latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`path[].longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

Los puntos consecutivos deberían estar a unos 300 metros como máximo para un buen ajuste.
Los puntos interpolados pueden no tener originalIndex. La herramienta no solicita límites de velocidad.

Resultado

Respuesta Roads original con snappedPoints y cualquier warningMessage. Conserva placeId, location y originalIndex cuando se proporcionan.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Encontrar tramos cercanos para 1–100 puntos GPS independientes; conserva originalIndex e IDs de lugar de carreteras.

Encontrar tramos cercanos para puntos GPS independientes sin interpretarlos como un recorrido continuo.

Comando CLI: nearest-roads. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`points` / `--points`	array de objetos; 1–100 elementos	Sí	—	Objetos de coordenadas independientes que ajustar.
`points[].latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`points[].longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

Un punto puede corresponder a varios tramos; conserve originalIndex y no suponga una salida por entrada.
No se solicitan límites de velocidad.

Resultado

Respuesta Roads original con snappedPoints, placeId de carretera, location y originalIndex que remite a los puntos de entrada.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Convertir coordenadas en una dirección.

Convertir coordenadas exactas en el primer resultado de geocodificación inversa. Use sus componentes si no basta una dirección formateada.

Comando CLI: reverse-geocode. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`latitude` / `--latitude`	número; -90.0–90.0	Sí	—	Latitud WGS84 en grados decimales; norte es positivo.
`longitude` / `--longitude`	número; -180.0–180.0	Sí	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

Solo se devuelve el primer resultado. No encontrar coincidencia es un error de herramienta.

Resultado

Primer resultado nativo Geocoding con formatted_address, address_components, geometry y place_id cuando existen.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_search_places

Buscar Places (New) por texto con filtros opcionales de ubicación y valoración.

Buscar Places (New) por texto con filtros opcionales de ubicación, valoración y tipo. Use los IDs devueltos para consultas selectivas de detalles.

Comando CLI: search-places. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`includedType` / `--included-type`	cadena; al menos 1 carácter(es)	No	Sin filtro de tipo	Tipo de lugar Google, como cafe.
`locationBias` / `--location-bias`	objeto	No	Sin sesgo de ubicación	Sesgo circular opcional; no es una restricción geográfica estricta.
`locationBias.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`locationBias.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.
`locationBias.radius`	número; 0.1–50000.0	No	5000	Radio del sesgo en metros.
`minRating` / `--min-rating`	número; 0.0–5.0	No	Sin filtro de valoración	Valoración mínima de usuarios solicitada a Google.
`openNow` / `--open-now`	booleano	No	Sin restricción por apertura	Limitar a lugares abiertos ahora cuando es true.
`query` / `--query`	cadena; al menos 1 carácter(es)	Sí	—	Consulta de lugares en lenguaje natural.

Comportamiento y restricciones

Solicita una página de 20 resultados y no devuelve ni sigue automáticamente un token de página.
Los datos ausentes de apertura/valoración dependen de Google; no interprete la búsqueda como un inventario completo.

Resultado

Array de hasta 20 objetos Google Place con campos seleccionados, enlaces Maps/origen y metadatos de atribución.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_search_nearby

Encontrar lugares alrededor de una dirección o coordenadas exactas y filtrar por tipo, valoración y apertura.

Encontrar lugares dentro de un radio delimitado alrededor de un centro resuelto. A diferencia de Text Search, usa una restricción circular estricta.

Comando CLI: search-nearby. Acceso Google: Places acepta clave API u OAuth. Los centros como dirección/lugar de interés también necesitan una clave API para resolverlos con Geocoding.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`center` / `--center`	objeto	Sí	—	Entrada del centro e indicador de cómo interpretarla.
`center.isCoordinates`	booleano	No	false	Tratar value como coordenadas exactas sin geocodificación.
`center.value`	cadena; al menos 1 carácter(es)	Si se proporciona el objeto padre	—	Dirección/lugar de interés, o cadena latitude,longitude cuando isCoordinates es true.
`keyword` / `--keyword`	cadena; al menos 1 carácter(es)	No	Sin filtro de tipo	Tipo de lugar Google pasado como includedTypes, por ejemplo cafe; no texto libre.
`minRating` / `--min-rating`	número; 0.0–5.0	No	Sin filtro de valoración	Valoración mínima aplicada localmente a los lugares devueltos.
`openNow` / `--open-now`	booleano	No	false	Conservar solo resultados con currentOpeningHours.openNow true.
`radius` / `--radius`	número; 0.1–50000.0	No	1000	Radio de búsqueda en metros.

Comportamiento y restricciones

Al filtrar, la apertura ausente no cuenta como abierto y la valoración ausente se considera 0.
Los centros como dirección requieren resolución; las coordenadas evitan esa llamada adicional.

Resultado

Array de hasta 20 objetos Place seleccionados. Los filtros locales de apertura/valoración pueden reducirlo.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Obtener detalles, reseñas y atribución. Las URLs opcionales conservan autores de fotos; muestre origen y avisos junto al contenido.

Ampliar un ID conocido con detalles seleccionados, reseñas y URLs opcionales de fotos. Conserve información de autor/origen y avisos de IA.

Comando CLI: place-details. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`maxPhotos` / `--max-photos`	entero; 0–10	No	0	Número máximo de consultas de URLs de medios de fotos.
`placeId` / `--place-id`	cadena; al menos 1 carácter(es)	Sí	—	ID de lugar Google, opcionalmente con prefijo places/.
`sessionToken` / `--session-token`	cadena; al menos 1 carácter(es)	No	Sin token; Google factura fuera de una sesión Autocomplete	Token Autocomplete (New) del mismo proyecto. Reutilice el token de predicción en esta solicitud final y cree otro para la siguiente sesión.

Comportamiento y restricciones

Cada foto seleccionada puede generar otra solicitud; cero fotos evita esas llamadas.
Usa una máscara fija de detalles, no todos los campos Google Place posibles. Pueden faltar campos no disponibles.

Resultado

Objeto Google Place nativo para la máscara de campos. Si se solicitan fotos, photoUrls contiene URLs de medios, atribución de autores y enlaces de origen.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_directions

Calcular una ruta entre ubicaciones con modo, horario y opciones de evitación.

Calcular una ruta entre dos extremos y exponer datos Google seleccionados junto con totales normalizados.

Comando CLI: directions. Acceso Google: Routes/Places admiten clave API u OAuth. Resolver lugares por nombre también necesita una clave API para Geocoding; las cadenas de coordenadas exactas evitan esa consulta.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`arrival_time` / `--arrival-time`	cadena; al menos 1 carácter(es)	No	No se proporciona	Llegada deseada RFC 3339 con zona horaria; solo modo transit.
`avoid_highways` / `--avoid-highways`	booleano	No	false	Evitar autopistas; true solo se admite al conducir.
`avoid_tolls` / `--avoid-tolls`	booleano	No	false	Evitar peajes; true solo se admite al conducir.
`departure_time` / `--departure-time`	cadena; al menos 1 carácter(es)	No	No se proporciona	Instante de salida RFC 3339 con Z o desfase UTC explícito.
`destination` / `--destination`	cadena; al menos 1 carácter(es)	Sí	—	Dirección/lugar de destino o cadena latitude,longitude exacta.
`mode` / `--mode`	cadena; valores: `driving`, `walking`, `bicycling`, `transit`	No	driving	Modo de desplazamiento. La conducción tiene en cuenta el tráfico.
`origin` / `--origin`	cadena; al menos 1 carácter(es)	Sí	—	Dirección/lugar de origen o cadena latitude,longitude exacta.
`polylineQuality` / `--polyline-quality`	cadena; valores: `OVERVIEW`, `HIGH_QUALITY`	No	HIGH_QUALITY si trafficSegments=true; en caso contrario, Google usa OVERVIEW por defecto	Calidad de la geometría: OVERVIEW o HIGH_QUALITY. La elección explícita siempre tiene prioridad, incluso OVERVIEW con trafficSegments=true. Controla la densidad de puntos independientemente del cálculo del tráfico.
`trafficSegments` / `--traffic-segments`	booleano	No	false	Opción booleana solo para conducción. Solicita TRAFFIC_ON_POLYLINE con geometría ENCODED_POLYLINE; usa HIGH_QUALITY salvo que polylineQuality sea explícita. El tráfico en polilíneas activa el SKU Compute Routes Enterprise, de mayor precio; mantener false si no se necesitan estos detalles.

Comportamiento y restricciones

departure_time y arrival_time no pueden proporcionarse juntos. arrival_time solo se acepta en transit.
Las opciones de evitación exigen driving. Google aplica restricciones adicionales de modo, horario y región.
La ausencia de ruta disponible es un error explícito.
Con trafficSegments=true, Routes devuelve intervalos NORMAL, SLOW o TRAFFIC_JAM. Los segmentos normalizados de cada ruta o etapa usan su propia polilínea e índices de puntos independientes. Los intervalos de Google son [start,end); la geometría conserva el vértice final compartido para cubrir la última arista. La cobertura ausente o inválida se indica expresamente, sin inventar tráfico normal.
segmentMetadata.retrievedAt es la hora local de obtención de la respuesta, no la hora de observación del tráfico del proveedor; trafficObservedAt es null porque Routes no la devuelve. roadCategory y speedLimit son null porque esta respuesta de Routes no los proporciona. No se realizan llamadas implícitas a Roads ni se aplican multiplicadores locales de duración; los tiempos siguen siendo predicciones de Google.
Los segmentos de tráfico son opcionales y se limitan a conducción en este ejecutable. Solicitarlos activa polilíneas con tráfico y facturación Compute Routes Enterprise. Contrato de intervalos; activadores de SKU actuales.
polylineQuality selecciona el detalle geométrico de Google: HIGH_QUALITY usa más puntos, aumenta el tamaño de la respuesta y puede elevar la latencia. OVERVIEW explícito sigue siendo válido con trafficSegments=true. Si se omite, los segmentos de tráfico usan HIGH_QUALITY; de lo contrario Google usa OVERVIEW. El programa no sintetiza ni interpola detalles adicionales. La calidad es independiente de extraComputations: HIGH_QUALITY por sí solo no activa TRAFFIC_ON_POLYLINE. Definición oficial de PolylineQuality.

Fuentes primarias: 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

Resultado

Objeto con routes, summary, total_distance (metros), total_duration (segundos) e índices opcionales de optimización. Las rutas incluyen etapas, pasos, polilínea y avisos seleccionados. Con trafficSegments=true, las rutas y etapas incluyen además segments normalizados y segmentMetadata.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_distance_matrix

Comparar distancias y duraciones para todos los pares origen/destino.

Comparar distancia y duración de cada par origen/destino. Revise celdas y errores individuales, sin dar por completa una respuesta correcta.

Comando CLI: distance-matrix. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`avoid_highways` / `--avoid-highways`	booleano	No	false	Evitar autopistas; true solo se admite al conducir.
`avoid_tolls` / `--avoid-tolls`	booleano	No	false	Evitar peajes; true solo se admite al conducir.
`departure_time` / `--departure-time`	cadena; al menos 1 carácter(es)	No	No se proporciona	Instante de salida RFC 3339 con Z o desfase UTC explícito.
`destinations` / `--destinations`	array de cadenas; 1–50 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Cadenas de destino: direcciones o pares latitude,longitude exactos.
`mode` / `--mode`	cadena; valores: `driving`, `walking`, `bicycling`, `transit`	No	driving	Modo de desplazamiento. La conducción tiene en cuenta el tráfico.
`origins` / `--origins`	array de cadenas; 1–50 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Cadenas de origen: direcciones o pares latitude,longitude exactos.

Comportamiento y restricciones

Como máximo 625 pares origen × destino; transit se limita a 100.
Como máximo 50 cadenas de origen/destino no coordenadas en total. Los límites por array no anulan este límite combinado.
Evitar peajes/autopistas solo se aplica a driving. Esta herramienta no expone arrival_time.
Una solicitud HTTP de matriz puede facturar varios elementos.

Resultado

Objeto con origin_addresses, destination_addresses, distances y durations por filas, y array errors. Los valores correctos son metros/segundos; celdas fallidas o ausentes permanecen null.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Obtener elevaciones geográficas para coordenadas.

Obtener la altura geográfica en puntos de coordenadas exactas.

Comando CLI: elevation. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`locations` / `--locations`	array de objetos; 1–512 elementos	Sí	—	Objetos de coordenadas para solicitar elevación.
`locations[].latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`locations[].longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

Devuelve los datos de Google sin convertir las unidades de elevación.

Resultado

Array nativo results de Elevation. Las entradas pueden contener elevation en metros, location y resolution.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_timezone

Obtener zona horaria, desfases UTC/horario de verano y hora local.

Resolver zona horaria y desfases UTC/horario de verano para un instante y derivar una marca de tiempo local.

Comando CLI: timezone. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`latitude` / `--latitude`	número; -90.0–90.0	Sí	—	Latitud WGS84 en grados decimales; norte es positivo.
`longitude` / `--longitude`	número; -180.0–180.0	Sí	—	Longitud WGS84 en grados decimales; este es positivo.
`timestamp` / `--timestamp`	entero; 0–253402300799999	No	Hora UTC actual en milisegundos	Milisegundos desde la época Unix, no segundos.

Comportamiento y restricciones

La solicitud convierte milisegundos en segundos enteros; no conserva precisión inferior al segundo.
La hora local usa los desfases base y de horario de verano devueltos para el instante solicitado.

Resultado

Campos como timeZoneId, timeZoneName, rawOffset y dstOffset en segundos, más localTime derivado en RFC 3339.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_weather

Obtener condiciones actuales y previsiones diarias u horarias para coordenadas.

Solicitar condiciones actuales o una página de previsión diaria/horaria para coordenadas exactas.

Comando CLI: weather. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`forecastDays` / `--forecast-days`	entero; 1–10	No	5	Duración solicitada de previsión diaria; solo con forecast_daily.
`forecastHours` / `--forecast-hours`	entero; 1–240	No	24	Duración solicitada de previsión horaria; solo con forecast_hourly.
`latitude` / `--latitude`	número; -90.0–90.0	Sí	—	Latitud WGS84 en grados decimales; norte es positivo.
`longitude` / `--longitude`	número; -180.0–180.0	Sí	—	Longitud WGS84 en grados decimales; este es positivo.
`type` / `--type`	cadena; valores: `current`, `forecast_daily`, `forecast_hourly`	No	current	Seleccionar condiciones actuales, previsión diaria o previsión horaria.

Comportamiento y restricciones

forecastDays se ignora para otros tipos; forecastHours solo se usa con forecast_hourly.
No sigue tokens de paginación automáticamente. El horizonte solicitado puede superar los registros de una página.
La cobertura y disponibilidad de previsiones dependen de Google.

Resultado

Respuesta Weather nativa: campos actuales, forecastDays o forecastHours, según type. Conserve unidades, marcas de tiempo y cualquier nextPageToken.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_air_quality

Obtener índices actuales de calidad del aire con contaminantes y recomendaciones de salud opcionales.

Obtener índices actuales de calidad del aire con concentraciones de contaminantes y recomendaciones del proveedor opcionales.

Comando CLI: air-quality. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`includeHealthRecommendations` / `--include-health-recommendations`	booleano	No	true	Solicitar el cálculo de recomendaciones de salud de Google.
`includePollutants` / `--include-pollutants`	booleano	No	false	Solicitar concentraciones de contaminantes.
`latitude` / `--latitude`	número; -90.0–90.0	Sí	—	Latitud WGS84 en grados decimales; norte es positivo.
`longitude` / `--longitude`	número; -180.0–180.0	Sí	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

Las recomendaciones son datos del proveedor, no una evaluación médica personalizada.
Expone condiciones actuales, no endpoints históricos o de previsión.

Resultado

Respuesta nativa Air Quality de condiciones actuales, con índices y healthRecommendations/pollutants opcionales si Google los proporciona.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_static_map

Crear un mapa PNG con marcadores y trazados opcionales.

Renderizar un mapa PNG con especificaciones opcionales de marcadores y trazados.

Comando CLI: static-map. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`center` / `--center`	cadena; al menos 1 carácter(es)	No	No se proporciona	Centro como dirección o cadena latitude,longitude.
`maptype` / `--maptype`	cadena; valores: `roadmap`, `satellite`, `terrain`, `hybrid`	No	roadmap	Estilo del mapa base.
`markers` / `--markers`	array de cadenas; 1–100 elementos; cada elemento al menos 1 carácter(es)	No	Sin marcadores	Especificaciones repetidas de marcador Google Static Maps, por ejemplo color:red\|48.8584,2.2945.
`path` / `--path`	array de cadenas; 1–100 elementos; cada elemento al menos 1 carácter(es)	No	Sin trazados	Especificaciones repetidas de trazado Google Static Maps, por ejemplo color:blue\|48.8584,2.2945\|48.8606,2.3376.
`size` / `--size`	cadena; patrón: `^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$`	No	600x400	Dimensiones WIDTHxHEIGHT en píxeles; cada dimensión se limita en ejecución a 1–640.
`zoom` / `--zoom`	entero; 0–21	No	Se omite; Google lo elige o infiere	Nivel de zoom explícito.

Comportamiento y restricciones

Se requiere al menos uno de center, markers o path.
La URL completa debe caber en 16.384 caracteres. El patrón de tamaño del esquema es más amplio que el límite real de 640 píxeles.
Los estilos de marcador/trazado siguen la sintaxis Google Static Maps. La atribución Google permanece en la imagen.

Resultado

MCP devuelve contenido image/png integrado. La CLI devuelve JSON {mimeType,base64} o bytes PNG con --output.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Geocodificar hasta 50 direcciones conservando éxito o error por dirección.

Geocodificar una lista limitada de direcciones conservando orden y éxito o fallo de cada elemento.

Comando CLI: batch-geocode. Acceso Google: Esta implementación requiere una clave API.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`addresses` / `--addresses`	array de cadenas; 1–50 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Cadenas de dirección/lugar de interés que resolver.

Comportamiento y restricciones

Concurrencia limitada a cinco solicitudes Google activas por proceso.
Los fallos por elemento no fuerzan una salida CLI distinta de cero; revise success/error en cada fila.

Resultado

Array en orden de entrada. Cada fila tiene address, success y data (objeto geocodificado) o error.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_explore_area

Resolver una ubicación y explorar categorías con detalles de los primeros resultados. Use lugares precisos para preparar recorridos.

Resolver una ubicación, buscar categorías seleccionadas alrededor y ampliar solo los primeros resultados de cada categoría.

Comando CLI: explore-area. Acceso Google: Places acepta clave API u OAuth. Los lugares con nombre también necesitan una clave API de Geocoding.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`location` / `--location`	cadena; al menos 1 carácter(es)	Sí	—	Dirección/lugar de interés o cadena latitude,longitude exacta.
`radius` / `--radius`	número; 0.1–50000.0	No	1000	Radio de búsqueda por categoría en metros.
`topN` / `--top-n`	entero; 1–20	No	3	Máximo de lugares por categoría que ampliar con detalles.
`types` / `--types`	array de cadenas; 1–10 elementos; cada elemento al menos 1 carácter(es)	No	restaurant, cafe, tourist_attraction	Categorías de lugares Google que buscar.

Comportamiento y restricciones

Cada categoría busca hasta 20 lugares; count es el recuento de la página, no un inventario agregado.
Los fallos de categorías y detalles siguen visibles en una respuesta global correcta.
Este compuesto hace varias solicitudes Google; limite categorías y topN a la tarea.

Resultado

Objeto con location resuelta, radius y categories. Cada categoría tiene type/count/top o error; los lugares ampliados pueden contener details_error.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_plan_route

Planificar una ruta de 2–27 paradas. Optimizar 2–25 paradas intermedias salvo transit; se conservan las coordenadas exactas.

Planificar una ruta única con paradas ordenadas, solicitando opcionalmente reordenar las intermedias y mantener extremos fijos.

Comando CLI: plan-route. Acceso Google: Routes/Places admiten clave API u OAuth. Resolver lugares por nombre también necesita una clave API para Geocoding; las cadenas de coordenadas exactas evitan esa consulta.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`avoid_highways` / `--avoid-highways`	booleano	No	false	Evitar autopistas; true solo se admite al conducir.
`avoid_tolls` / `--avoid-tolls`	booleano	No	false	Evitar peajes; true solo se admite al conducir.
`departure_time` / `--departure-time`	cadena; al menos 1 carácter(es)	No	No se proporciona	Instante de salida RFC 3339 con Z o desfase UTC explícito.
`mode` / `--mode`	cadena; valores: `driving`, `walking`, `bicycling`, `transit`	No	driving	Modo de desplazamiento. La conducción tiene en cuenta el tráfico.
`optimize` / `--optimize`	booleano	No	true, sujeto a esas condiciones	Solicitar optimización intermedia cuando hay más de tres paradas totales y el modo no es transit.
`polylineQuality` / `--polyline-quality`	cadena; valores: `OVERVIEW`, `HIGH_QUALITY`	No	HIGH_QUALITY si trafficSegments=true; en caso contrario, Google usa OVERVIEW por defecto	Calidad de la geometría: OVERVIEW o HIGH_QUALITY. La elección explícita siempre tiene prioridad, incluso OVERVIEW con trafficSegments=true. Controla la densidad de puntos independientemente del cálculo del tráfico.
`stops` / `--stops`	array de cadenas; 2–27 elementos; cada elemento al menos 1 carácter(es)	Sí	—	Direcciones/lugares o cadenas latitude,longitude exactas ordenadas; primera/última siguen siendo extremos.
`trafficSegments` / `--traffic-segments`	booleano	No	false	Opción booleana solo para conducción. Solicita TRAFFIC_ON_POLYLINE con geometría ENCODED_POLYLINE; usa HIGH_QUALITY salvo que polylineQuality sea explícita. El tráfico en polilíneas activa el SKU Compute Routes Enterprise, de mayor precio; mantener false si no se necesitan estos detalles.

Comportamiento y restricciones

Transit admite solo dos extremos, sin paradas intermedias.
La optimización solo actúa con cuatro paradas totales o más, al menos dos intermedias.
Optimiza el orden de paradas de una ruta, no la asignación de vehículos/tareas de una flota.
Con trafficSegments=true, Routes devuelve intervalos NORMAL, SLOW o TRAFFIC_JAM. Los segmentos normalizados de cada ruta o etapa usan su propia polilínea e índices de puntos independientes. Los intervalos de Google son [start,end); la geometría conserva el vértice final compartido para cubrir la última arista. La cobertura ausente o inválida se indica expresamente, sin inventar tráfico normal.
segmentMetadata.retrievedAt es la hora local de obtención de la respuesta, no la hora de observación del tráfico del proveedor; trafficObservedAt es null porque Routes no la devuelve. roadCategory y speedLimit son null porque esta respuesta de Routes no los proporciona. No se realizan llamadas implícitas a Roads ni se aplican multiplicadores locales de duración; los tiempos siguen siendo predicciones de Google.
Los segmentos de tráfico son opcionales y se limitan a conducción en este ejecutable. Solicitarlos activa polilíneas con tráfico y facturación Compute Routes Enterprise. Contrato de intervalos; activadores de SKU actuales.
polylineQuality selecciona el detalle geométrico de Google: HIGH_QUALITY usa más puntos, aumenta el tamaño de la respuesta y puede elevar la latencia. OVERVIEW explícito sigue siendo válido con trafficSegments=true. Si se omite, los segmentos de tráfico usan HIGH_QUALITY; de lo contrario Google usa OVERVIEW. El programa no sintetiza ni interpola detalles adicionales. La calidad es independiente de extraComputations: HIGH_QUALITY por sí solo no activa TRAFFIC_ON_POLYLINE. Definición oficial de PolylineQuality.

Resultado

Objeto con mode, optimized efectivo, stops resueltas en orden, legs para mostrar, total_distance, total_duration, polilínea y avisos. durationSeconds de una etapa son segundos numéricos. Con trafficSegments=true, las rutas y etapas incluyen además segments normalizados y segmentMetadata.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Buscar y comparar lugares con detalles y distancia en coche opcional desde userLocation.

Buscar y enriquecer una selección breve de lugares, comparando opcionalmente distancia en coche desde coordenadas exactas del usuario.

Comando CLI: compare-places. Acceso Google: Places y Routes opcional admiten clave API u OAuth.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`limit` / `--limit`	entero; 1–20	No	5	Máximo de lugares coincidentes que enriquecer.
`query` / `--query`	cadena; al menos 1 carácter(es)	Sí	—	Consulta de búsqueda de texto Places.
`userLocation` / `--user-location`	objeto	No	Sin comparación de distancia/tiempo	Coordenadas exactas del usuario para comparar distancias opcionalmente.
`userLocation.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`userLocation.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.

Comportamiento y restricciones

La comparación usa driving; esta herramienta no permite configurar el modo de desplazamiento.
Los fallos de detalles y distancia se conservan sin eliminar lugares que siguen siendo utilizables.
Solo se enriquece la selección solicitada.

Resultado

Objeto con places y distance_error opcional. Los lugares pueden incluir details/details_error, distance, drive_time y distance_errors por lugar.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Encontrar lugares a lo largo de una ruta usando su polilínea codificada.

Calcular una ruta y buscar Places con su polilínea codificada, sin aproximar el trayecto con una única búsqueda circular.

Comando CLI: search-along-route. Acceso Google: Routes/Places admiten clave API u OAuth. Resolver lugares por nombre también necesita una clave API para Geocoding; las cadenas de coordenadas exactas evitan esa consulta.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`destination` / `--destination`	cadena; al menos 1 carácter(es)	Sí	—	Destino de ruta como dirección/lugar o cadena latitude,longitude exacta.
`maxResults` / `--max-results`	entero; 1–20	No	5	Máximo de resultados Places solicitado en la página de respuesta.
`mode` / `--mode`	cadena; valores: `driving`, `walking`, `bicycling`, `transit`	No	walking	Modo de desplazamiento de la ruta usada por la búsqueda.
`origin` / `--origin`	cadena; al menos 1 carácter(es)	Sí	—	Origen de ruta como dirección/lugar o cadena latitude,longitude exacta.
`textQuery` / `--text-query`	cadena; al menos 1 carácter(es)	Sí	—	Consulta Places de paradas a lo largo de la ruta, como cafés o cargadores.

Comportamiento y restricciones

El modo predeterminado es walking, mientras directions, matrix y plan-route usan driving.
No hay paginación automática ni ampliación Place Details.
No expone los parámetros de salida/llegada ni evitación de directions.

Resultado

Objeto con places, routingSummaries opcionales y route calculada, con datos Google seleccionados y totales normalizados.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Medir posiciones de búsqueda para 1–3 palabras clave en una cuadrícula; devuelve ARP, ATRP, SoLV y errores por punto.

Medir la aparición de un lugar objetivo entre los primeros 20 resultados Text Search en cada punto de una cuadrícula.

Comando CLI: local-rank-tracker. Acceso Google: Clave API u OAuth para la API principal.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`center` / `--center`	objeto	Sí	—	Centro exacto de la cuadrícula.
`center.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	—	Latitud WGS84 en grados decimales; norte es positivo.
`center.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	—	Longitud WGS84 en grados decimales; este es positivo.
`gridSize` / `--grid-size`	entero; 3–7	No	3	Número de filas y columnas; se aceptan todos los enteros de 3–7.
`gridSpacing` / `--grid-spacing`	número; 100.0–10000.0	No	1000	Distancia en metros entre puntos vecinos de la cuadrícula.
`keyword` / `--keyword`	cadena; al menos 1 carácter(es)	No	No se proporciona	Palabra de búsqueda única; use keyword o keywords.
`keywords` / `--keywords`	array de cadenas; 1–3 elementos; cada elemento al menos 1 carácter(es)	No	No se proporciona	De una a tres palabras de búsqueda; prevalece si se proporcionan ambas formas.
`placeId` / `--place-id`	cadena; al menos 1 carácter(es)	Sí	—	ID del lugar objetivo, opcionalmente con prefijo places/.

Comportamiento y restricciones

Se requiere al menos keyword o keywords; las filas individuales del esquema no expresan esa alternativa.
Las solicitudes crecen como número de palabras × gridSize², hasta 147 antes de reintentos.
Los puntos fallidos se excluyen de las métricas, no se cuentan como ausencias válidas. Las métricas pueden ser null sin observaciones utilizables.
Una posición de búsqueda no es la valoración de reseñas. Son muestras de búsquedas de texto con sesgo, no garantías de la posición que verá un usuario en Google Maps.

Resultado

Objeto con target, grid_size, grid_spacing_m y métricas/cuadrícula por palabra. ARP promedia posiciones encontradas; ATRP usa posición 21 para consultas correctas sin el objetivo; SoLV es el porcentaje de puntos correctos en las primeras 3 posiciones. failed_points y found_in muestran cobertura.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Consultar límites de velocidad para automóviles mediante puntos GPS o ID de segmentos Roads. Esta función restringida requiere acceso Asset Tracking; habilitar Roads no basta.

Comando CLI: speed-limits. Acceso Google: Se requiere clave API en esta implementación, incluso en modo OAuth. La autorización de Speed Limits es independiente de las credenciales.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`path` / `--path`	array de objetos; 1–100 elementos	No	No indicado	De 1 a 100 coordenadas GPS; incompatible con roadPlaceIds. Google ajusta el trayecto a las carreteras.
`path[].latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio para cada punto	Latitud WGS84 en grados, de -90 a 90.
`path[].longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio para cada punto	Longitud WGS84 en grados, de -180 a 180.
`roadPlaceIds` / `--road-place-ids`	array de cadenas; 1–100 elementos; cada elemento al menos 1 carácter(es)	No	No indicado	De 1 a 100 ID de segmentos obtenidos con maps_snap_to_roads o maps_nearest_roads; los ID de lugares comunes pueden no tener datos. Incompatible con path.
`units` / `--units`	cadena; valores: `KPH`, `MPH`	No	KPH	Unidad de los límites: KPH (km/h) o MPH (millas/h).

Comportamiento y restricciones

Google limita este servicio a licencias Asset Tracking y determinados proyectos Premium anteriores con esa capacidad. La activación y la facturación no conceden acceso por sí solas. https://developers.google.com/maps/documentation/roads/speed-limits
Cada entrada speedLimits devuelta puede facturarse por separado. Solicite el lote mínimo necesario.
Para límites variables Google devuelve el máximo para automóviles. Los datos no son en tiempo real y pueden faltar o estar desactualizados; respete las señales.
Un error 403 conserva el motivo de Google depurado y añade una indicación de acceso. También pueden causarlo las restricciones de clave, permisos o activación.

Fuentes primarias: https://developers.google.com/maps/documentation/roads/speed-limits

Resultado

Respuesta Roads nativa completa con speedLimits, unidades, snappedPoints opcionales, avisos y metadatos de Google.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_autocomplete

Predecir lugares y consultas mientras se escribe mediante Places API (New), filtros geográficos, idioma, cursor y tokens de sesión gestionados por el cliente.

Comando CLI: autocomplete. Acceso Google: Clave API u OAuth con ámbito Places/cloud-platform.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`includeFutureOpeningBusinesses` / `--include-future-opening-businesses`	booleano	No	false	Incluir negocios que abrirán en el futuro.
`includePureServiceAreaBusinesses` / `--include-pure-service-area-businesses`	booleano	No	false	Incluir negocios que visitan o entregan a clientes sin dirección comercial pública.
`includeQueryPredictions` / `--include-query-predictions`	booleano	No	false	Incluir predicciones de consultas además de lugares.
`includedPrimaryTypes` / `--included-primary-types`	array de cadenas; 0–5 elementos; cada elemento al menos 1 carácter(es)	No	Todos los tipos	Hasta cinco tipos principales. (cities) o (regions) debe ser el único valor.
`includedRegionCodes` / `--included-region-codes`	array de cadenas; 0–15 elementos	No	Todas las regiones	Hasta 15 códigos CLDR de dos letras; se intersectan con locationRestriction. Una lista vacía no restringe.
`input` / `--input`	cadena; al menos 1 carácter(es)	Sí	—	Texto no vacío, incluidos nombres o direcciones parciales.
`inputOffset` / `--input-offset`	entero; 0–4294967295	No	Final del texto	Posición del cursor como índice de caracteres Unicode desde cero; no debe superar la longitud del texto.
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	GOOGLE_MAPS_LANGUAGE configurado	Idioma IETF BCP-47 preferido; pueden aparecer varios idiomas.
`locationBias` / `--location-bias`	objeto	No	Sesgo IP Google sin opción geográfica	Priorizar exactamente un círculo o rectángulo; puede haber resultados fuera. Incompatible con locationRestriction.
`locationBias.circle`	objeto	No	No indicado	Zona circular; incompatible con rectangle.
`locationBias.circle.center`	objeto	Si se proporciona el objeto padre	Obligatorio con circle	Centro WGS84 del círculo.
`locationBias.circle.center.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con center	Latitud del centro en grados.
`locationBias.circle.center.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con center	Longitud del centro en grados.
`locationBias.circle.radius`	número; 0.0–50000.0	Si se proporciona el objeto padre	Obligatorio con circle	Radio en metros, máximo 50 000; positivo para locationRestriction.
`locationBias.rectangle`	objeto	No	No indicado	Rectángulo cerrado; incompatible con circle. Las longitudes pueden cruzar el antimeridiano.
`locationBias.rectangle.high`	objeto	Si se proporciona el objeto padre	Obligatorio con rectangle	Límite noreste.
`locationBias.rectangle.high.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con límite	Latitud WGS84; low no debe superar high.
`locationBias.rectangle.high.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con límite	Longitud WGS84; low > high indica cruce del antimeridiano.
`locationBias.rectangle.low`	objeto	Si se proporciona el objeto padre	Obligatorio con rectangle	Límite suroeste.
`locationBias.rectangle.low.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con límite	Latitud WGS84; low no debe superar high.
`locationBias.rectangle.low.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con límite	Longitud WGS84; low > high indica cruce del antimeridiano.
`locationRestriction` / `--location-restriction`	objeto	No	Sesgo IP Google sin opción geográfica	Limitar a exactamente un círculo o rectángulo. Incompatible con locationBias.
`locationRestriction.circle`	objeto	No	No indicado	Zona circular; incompatible con rectangle.
`locationRestriction.circle.center`	objeto	Si se proporciona el objeto padre	Obligatorio con circle	Centro WGS84 del círculo.
`locationRestriction.circle.center.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con center	Latitud del centro en grados.
`locationRestriction.circle.center.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con center	Longitud del centro en grados.
`locationRestriction.circle.radius`	número; 0.0–50000.0	Si se proporciona el objeto padre	Obligatorio con circle	Radio en metros, máximo 50 000; positivo para locationRestriction.
`locationRestriction.rectangle`	objeto	No	No indicado	Rectángulo cerrado; incompatible con circle. Las longitudes pueden cruzar el antimeridiano.
`locationRestriction.rectangle.high`	objeto	Si se proporciona el objeto padre	Obligatorio con rectangle	Límite noreste.
`locationRestriction.rectangle.high.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con límite	Latitud WGS84; low no debe superar high.
`locationRestriction.rectangle.high.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con límite	Longitud WGS84; low > high indica cruce del antimeridiano.
`locationRestriction.rectangle.low`	objeto	Si se proporciona el objeto padre	Obligatorio con rectangle	Límite suroeste.
`locationRestriction.rectangle.low.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con límite	Latitud WGS84; low no debe superar high.
`locationRestriction.rectangle.low.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con límite	Longitud WGS84; low > high indica cruce del antimeridiano.
`origin` / `--origin`	objeto	No	Distancia omitida	Coordenada de referencia para la distancia geodésica distanceMeters.
`origin.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con origin	Latitud WGS84 en grados.
`origin.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con origin	Longitud WGS84 en grados.
`regionCode` / `--region-code`	cadena; patrón: `^[A-Za-z]{2}$`	No	No indicado	Código CLDR de dos letras para formato y clasificación; no limita la región.
`sessionToken` / `--session-token`	cadena; al menos 1 carácter(es); patrón: `^[A-Za-z0-9_-]+$`	No	Sin agrupación; facturación por solicitud	Token seguro para URL creado por el cliente, máximo 36 caracteres ASCII; se recomienda UUID v4. Reutilizar en la solicitud final Details o Address Validation.

Comportamiento y restricciones

El cliente crea y termina las sesiones. Todas las credenciales de una sesión deben pertenecer al mismo proyecto Google Cloud. Finalice con Details o Address Validation apropiado y cree otro token; omitir o reutilizar tokens puede generar facturación por solicitud.
Círculos: máximo 50 km y radio positivo para restricciones. Las latitudes del rectángulo deben estar ordenadas; se admite cruzar el antimeridiano.
Conserve atribuciones de Google Maps y proveedores. Las condiciones EEE y los campos disponibles pueden variar. Referencia: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

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

Resultado

Respuesta suggestions nativa completa: placePrediction/queryPrediction, posiciones de coincidencia, texto estructurado, ID, distancia opcional y metadatos. No se filtran campos.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Estimar la ubicación de un dispositivo a partir de antenas celulares o puntos WiFi con el cuerpo JSON nativo completo de Google Geolocation.

Comando CLI: geolocate. Acceso Google: Se requiere clave API; www.googleapis.com la recibe como parámetro de consulta incluso con POST.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`body` / `--body`	objeto	Sí	—	Objeto Google nativo: homeMobileCountryCode, homeMobileNetworkCode, radioType (gsm/cdma/wcdma/lte/nr), carrier, considerIp, cellTowers, wifiAccessPoints, cellId/newRadioCellId y señales. La referencia oficial describe todos los campos anidados. Un objeto vacío permite la alternativa IP del servidor.

Comportamiento y restricciones

Esquema completo de radio/WiFi: https://developers.google.com/maps/documentation/geolocation/requests-geolocation
Google usa considerIp=true por defecto. La alternativa IP localiza la salida de red del servidor, no a la persona. Use body.considerIp=false para impedirla.
WiFi necesita al menos dos puntos fijos físicamente distintos. Se excluyen MAC locales/reservadas; los puntos móviles pueden no dar resultados.
El cuerpo nativo es extensible y lo valida Google; se rechazan parámetros externos desconocidos. Puede producirse NOT_FOUND; revise accuracy.

Fuentes primarias: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

Resultado

location.lat/location.lng y accuracy, radio de incertidumbre en metros, más los campos nativos adicionales.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Usar los tres métodos principales de Solar: información del edificio cercano, metadatos de capas ráster regionales y descarga GeoTIFF limitada por ID.

Comando CLI: solar. Acceso Google: Clave API u OAuth cloud-platform. Las cuentas de servicio necesitan la API habilitada y serviceusage.services.use en el proyecto de cuota.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`additionalInsights` / `--additional-insights`	array de cadenas; 0–1 elementos; valores: `DETECTED_ARRAYS`	No	Sin información adicional	DETECTED_ARRAYS opcional para building_insights, para obtener paneles solares detectados.
`exactQualityRequired` / `--exact-quality-required`	booleano	No	false	Exigir la calidad exacta en vez de aceptar una superior, para información o capas.
`experiments` / `--experiments`	array de cadenas; 0–1 elementos; valores: `EXPANDED_COVERAGE`	No	Sin experimentos	EXPANDED_COVERAGE opcional para información/capas; Google considera estas solicitudes previas a disponibilidad general.
`id` / `--id`	cadena; al menos 1 carácter(es)	No	— para geo_tiff	ID opaco del parámetro id de una URL de capa Solar. Obligatorio solo para geo_tiff; no indique la URL.
`location` / `--location`	objeto	No	No indicado	Coordenada del edificio o centro regional; obligatoria para building_insights/data_layers.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud WGS84 en grados.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud WGS84 en grados.
`operation` / `--operation`	cadena; valores: `building_insights`, `data_layers`, `geo_tiff`	Sí	—	building_insights, data_layers o geo_tiff; solo se aceptan parámetros de la operación elegida.
`pixelSizeMeters` / `--pixel-size-meters`	número; valores: `0.1`, `0.25`, `0.5`, `1.0`	No	0.1	Escala mínima del píxel: 0.1, 0.25, 0.5 o 1.0 m; algunas capas tienen resolución nativa menor.
`radiusMeters` / `--radius-meters`	número; sin límite–1000	No	No indicado	Radio positivo obligatorio para data_layers, máximo 1 000 m. Sobre 100 m: <= pixelSizeMeters × 1 000. Sobre 175 m: excluir flujo mensual y sombra horaria.
`requiredQuality` / `--required-quality`	cadena; valores: `HIGH`, `MEDIUM`, `BASE`	No	HIGH (valor Google)	Calidad mínima HIGH, MEDIUM o BASE; BASE usa imágenes satelitales mejoradas. La cobertura varía.
`view` / `--view`	cadena; valores: `DSM_LAYER`, `IMAGERY_LAYERS`, `IMAGERY_AND_ANNUAL_FLUX_LAYERS`, `IMAGERY_AND_ALL_FLUX_LAYERS`, `FULL_LAYERS`	No	FULL_LAYERS (valor Google)	Subconjunto: DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS o FULL_LAYERS.

Comportamiento y restricciones

Métodos: 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
La cobertura y calidad varían por país. Puede haber NOT_FOUND si no hay un edificio a unos 50 m. https://developers.google.com/maps/documentation/solar/coverage
Las URL de capas caducan y requieren autenticación. Copie solo su id a geo_tiff; la descarga siempre usa solar.googleapis.com/v1/geoTiff:get, nunca hosts arbitrarios.
Los GeoTIFF están limitados a 16 MiB, al presupuesto de solicitudes y al plazo de la herramienta. Reduzca el radio o use píxeles mayores si es necesario. No incluye decodificación ráster ni diseño de instalaciones.
EXPANDED_COVERAGE es experimental, previo a disponibilidad general. Los proyectos facturados en el EEE pueden tener condiciones y contenido distintos. https://developers.google.com/maps/comms/eea/solar
Se aplican facturación y cuotas distintas; habilitar la API no hace gratuitas las consultas. Conserve la atribución Google Maps.

Fuentes primarias: 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

Resultado

building_insights/data_layers devuelven JSON Google completo con fechas/calidad de imágenes, potencial solar y URL ráster temporales sin credenciales. geo_tiff devuelve bytes limitados con MIME y metadatos HTTP conservados; el JSON CLI usa base64.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Obtener URL temporales de reproducción o metadatos de un vídeo Aerial View existente, sin descargarlo.

Comando CLI: aerial-view. Acceso Google: Se requiere clave API en esta implementación, incluso en modo OAuth.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`address` / `--address`	cadena; al menos 1 carácter(es)	No	No indicado	Dirección postal de EE. UU. admitida. Indique exactamente address o videoId.
`operation` / `--operation`	cadena; valores: `lookup`, `metadata`	No	lookup	lookup devuelve URL y metadatos y se factura; metadata no devuelve URL y es gratuito.
`videoId` / `--video-id`	cadena; al menos 1 carácter(es)	No	No indicado	ID Aerial View obtenido anteriormente. Indique exactamente videoId o address.

Comportamiento y restricciones

Solo direcciones postales de EE. UU. con cobertura 3D. NOT_FOUND indica que no existe el vídeo; maps_render_aerial_video solicita su creación por separado.
metadata consulta el estado gratis y sin URL. lookup se factura; deje intervalos razonables mientras se procesa.
Las URL caducan pronto: solicite otras para cada visualización. Google prohíbe descargar, almacenar o guardar estos vídeos en caché; los ID de vídeo están exceptuados. https://developers.google.com/maps/documentation/aerial-view/lookup-video
Conserve la atribución Google Maps durante la reproducción. Las condiciones EEE pueden variar. https://developers.google.com/maps/documentation/aerial-view/policies

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

Resultado

Respuesta Google nativa con estado, metadatos y, para lookup activo, URL por formato/resolución. metadata no contiene URL de reproducción.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_render_aerial_video

Solicitar explícitamente un renderizado Aerial View asíncrono para una dirección postal de EE. UU. admitida; esta acción modifica la cola de Google.

Comando CLI: render-aerial-video. Acceso Google: Se requiere clave API en esta implementación, incluso en modo OAuth.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`address` / `--address`	cadena; al menos 1 carácter(es)	Sí	—	Dirección postal de EE. UU. admitida para renderizar.

Comportamiento y restricciones

La acción modifica la cola Google. No se reintenta automáticamente, no espera a la finalización y no descarga el vídeo.
Consulte el progreso con maps_aerial_view y operation metadata; use lookup solo cuando necesite URL de reproducción.
Se aplican cobertura EE. UU./3D, cuotas y condiciones Google; activar la API no garantiza el renderizado. https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo
No descargue, almacene ni guarde vídeos en caché; muestre las URL temporales actuales con la atribución exigida.

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

Resultado

Respuesta nativa con estado y metadatos disponibles. PROCESSING indica procesamiento en curso; un vídeo existente puede devolver ACTIVE inmediatamente.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_map_tiles

Crear sesiones Map Tiles y obtener recursos 2D, 3D fotorrealistas y Street View para un visor. No incluye renderizador. La licencia permite visualización, no interpretación automática, análisis de imágenes, extracción geográfica ni uso sin conexión.

Comando CLI: map-tiles. Acceso Google: Clave API u OAuth cloud-platform con proyecto de cuota facturado. Habilite Map Tiles; las cuentas de servicio necesitan permisos Service Usage en el proyecto de cuota.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`east` / `--east`	número; -180.0–180.0	No	No indicado; obligatorio para las operaciones descritas	Longitud este; east negativo y west positivo pueden cruzar el antimeridiano.
`fov` / `--fov`	número; 30.0–120.0	No	90	Campo horizontal de miniatura, 30–120 grados.
`height` / `--height`	entero; 16–250	No	250	Alto de miniatura, 16–250 píxeles.
`latitude` / `--latitude`	número; -90.0–90.0	No	No indicado; obligatorio para las operaciones descritas	Latitud de búsqueda streetview_metadata; requiere longitude y excluye panoId.
`locations` / `--locations`	array de objetos; 1–100 elementos	No	No indicado; obligatorio para las operaciones descritas	De 1 a 100 objetos de búsqueda con lat y lng para streetview_pano_ids.
`locations[].lat`	número; -90.0–90.0	Si se proporciona el objeto padre	No indicado; obligatorio para las operaciones descritas	Latitud WGS84 del centro de búsqueda.
`locations[].lng`	número; -180.0–180.0	Si se proporciona el objeto padre	No indicado; obligatorio para las operaciones descritas	Longitud WGS84 del centro de búsqueda.
`longitude` / `--longitude`	número; -180.0–180.0	No	No indicado; obligatorio para las operaciones descritas	Longitud de búsqueda streetview_metadata; requiere latitude y excluye panoId.
`north` / `--north`	número; -90.0–90.0	No	No indicado; obligatorio para las operaciones descritas	Latitud norte WGS84 de viewport, mayor que south.
`operation` / `--operation`	cadena; valores: `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; selecciona el contrato.
`panoId` / `--pano-id`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	Obligatorio para teselas/miniaturas, alternativo a coordenadas para metadatos. ID temporal para una sesión de usuario.
`pitch` / `--pitch`	número; -90.0–90.0	No	0	Orientación vertical de miniatura, -90 a 90 grados.
`radius` / `--radius`	número; 0.0–100000.0	No	50 metros	Radio Street View en metros para búsqueda por coordenadas; entero 0–100000. Incompatible con panoId en metadatos.
`resourceUrl` / `--resource-url`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	URL Google absoluta https://tile.googleapis.com/v1/3dtiles/... para resource_3d; sin hosts distintos, puertos, usuario, fragmentos ni segmentos codificados. La clave recibida se sustituye por las credenciales configuradas.
`session` / `--session`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	Token createSession obligatorio en 2D y Street View, no en 3D. Respete la caducidad devuelta.
`sessionOptions` / `--session-options`	objeto	No	No indicado; obligatorio para las operaciones descritas	Opciones Google nativas para create_session; mapType, language y region obligatorios.
`sessionOptions.highDpi`	booleano	No	false	Aumentar dimensiones en píxeles con escala 2x/4x; sin efecto con 1x.
`sessionOptions.imageFormat`	cadena; valores: `jpeg`, `png`	No	Google elige el mejor formato	Codificación jpeg o png; JPEG no admite transparencia.
`sessionOptions.language`	cadena; al menos 1 carácter(es)	Si se proporciona el objeto padre	No indicado; obligatorio para las operaciones descritas	Etiqueta de idioma IETF, por ejemplo es-ES.
`sessionOptions.layerTypes`	array de cadenas; 1–3 elementos; valores: `layerRoadmap`, `layerStreetview`, `layerTraffic`	No	Sin capas adicionales	De uno a tres valores layerRoadmap, layerStreetview, layerTraffic. terrain requiere layerRoadmap.
`sessionOptions.mapType`	cadena; valores: `roadmap`, `satellite`, `terrain`, `streetview`	Si se proporciona el objeto padre	No indicado; obligatorio para las operaciones descritas	roadmap, satellite, terrain o streetview; terrain requiere layerRoadmap en layerTypes.
`sessionOptions.overlay`	booleano	No	false	Mostrar layerTypes sin imagen base.
`sessionOptions.region`	cadena; patrón: `^[A-Z]{2}$`	Si se proporciona el objeto padre	No indicado; obligatorio para las operaciones descritas	Dos letras CLDR mayúsculas que indican la ubicación física del usuario.
`sessionOptions.scale`	cadena; valores: `scaleFactor1x`, `scaleFactor2x`, `scaleFactor4x`	No	scaleFactor1x	scaleFactor1x, scaleFactor2x o scaleFactor4x controla el tamaño de los elementos.
`sessionOptions.styles`	array de objetos; 1–100 elementos	No	Estilo Google	Estilos JSON Google nativos, solo para roadmap. https://developers.google.com/maps/documentation/tile/style-reference
`south` / `--south`	número; -90.0–90.0	No	No indicado; obligatorio para las operaciones descritas	Latitud sur WGS84 de viewport.
`west` / `--west`	número; -180.0–180.0	No	No indicado; obligatorio para las operaciones descritas	Longitud oeste de viewport.
`width` / `--width`	entero; 16–600	No	600	Ancho de miniatura, 16–600 píxeles.
`x` / `--x`	entero; 0–4194303	No	No indicado; obligatorio para las operaciones descritas	Columna de tesela; en 2D x < 2^zoom, en Street View los límites dependen del panorama.
`y` / `--y`	entero; 0–4194303	No	No indicado; obligatorio para las operaciones descritas	Fila de tesela; en 2D y < 2^zoom, en Street View los límites dependen del panorama.
`yaw` / `--yaw`	número; -360.0–360.0	No	0	Orientación horizontal de miniatura, -360 a 360 grados.
`zoom` / `--zoom`	entero; 0–22	No	No indicado; obligatorio para las operaciones descritas	Zoom entero 0–22 para tile_2d/viewport; 0–5 para streetview_tile. Consulte el máximo en viewport.

Comportamiento y restricciones

create_session requiere sessionOptions; tile_2d: session/zoom/x/y; viewport: session/zoom/north/south/east/west; root_3d: ningún otro campo; resource_3d: resourceUrl; streetview_pano_ids: session/locations; streetview_metadata: session y panoId o latitude+longitude; streetview_thumbnail: session/panoId; streetview_tile: session/panoId/zoom/x/y. Se rechazan campos no usados.
La creación de sesión no se reintenta automáticamente. Las consultas de panoramas son POST de lectura. El cliente debe unir las teselas y renderizar 3D.
Solo visualización. No precargar, indexar, almacenar ni guardar en caché sin permiso, ni analizar con agentes. Respete Cache-Control, ETag y el acuerdo Google. https://developers.google.com/maps/documentation/tile/policies
Muestre el logo Google Maps y atribuciones: copyright viewport para 2D; copyright y enlace de problemas de metadatos Street View; copyright de teselas para 3D. No oculte créditos.
Varían cobertura, condiciones EEE, facturación y cuotas. Rige la caducidad nativa; panoId es temporal. No hay caché, descarga masiva, modo sin conexión ni análisis de imágenes.
Contratos: https://developers.google.com/maps/documentation/tile/session_tokens ; https://developers.google.com/maps/documentation/tile/2d-tiles-overview ; https://developers.google.com/maps/documentation/tile/streetview ; https://developers.google.com/maps/documentation/tile/3d-tiles

Fuentes primarias: 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

Resultado

JSON Google nativo de sesiones, ventanas, panoramas y conjuntos 3D. Conserva atribuciones, copyright, reportProblemLink y caducidad. Los recursos binarios mantienen MIME y caché/ETag; MCP muestra imágenes compatibles o base64. CLI --output escribe los bytes.

Ejemplo

Argumentos MCP:

json

{
  "operation": "root_3d"
}

Llamada CLI equivalente:

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

maps_streetview

Consultar metadatos Street View u obtener un JPEG estático mediante ubicación o ID de panorama. Revise los metadatos antes de solicitar una imagen facturada.

Comando CLI: streetview. Acceso Google: Se requiere clave API y Street View Static habilitado; OAuth solo no basta. Google recomienda firma digital y la exige para ciertas cuentas.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`fov` / `--fov`	número; 1.0–120.0	No	90	Campo de visión horizontal, 1–120 grados.
`heading` / `--heading`	número; 0.0–360.0	No	Google orienta hacia la ubicación indicada	Rumbo de la cámara, de 0 a 360 grados.
`height` / `--height`	entero; 1–640	No	400	Alto de imagen, 1–640 píxeles, solo para image.
`location` / `--location`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	Dirección, cadena latitude,longitude o place_id:PLACE_ID. Indique exactamente location o panoId.
`operation` / `--operation`	cadena; valores: `metadata`, `image`	Sí	—	metadata devuelve JSON; image devuelve bytes JPEG.
`panoId` / `--pano-id`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	ID de panorama incompatible con location; conserve la ubicación original para actualizar los ID cambiantes.
`pitch` / `--pitch`	número; -90.0–90.0	No	0	Ángulo vertical, -90 a 90 grados.
`radius` / `--radius`	entero; 0–100000	No	50	Radio de búsqueda entero en metros, de 0 a 100000 en esta herramienta.
`returnErrorCode` / `--return-error-code`	booleano	No	true en esta implementación	Con image, devolver error HTTP en vez de la imagen gris de ausencia de cobertura.
`signature` / `--signature`	cadena; al menos 1 carácter(es)	No	No indicado	Firma URL opcional de la solicitud codificada exacta. Recomendada y a veces obligatoria; se transmite pero no se genera. En solicitudes firmadas, signature se añade al final, después de la clave API. Firma la ruta y consulta codificadas exactas, incluidos los valores predeterminados generados. Orden de imagen: location, radius, source, pano, size, heading, fov, pitch, return_error_code, key; se omiten las opciones ausentes. Los metadatos omiten los campos de imagen. Los espacios se codifican como +. Valores predeterminados: size=640x400 y return_error_code=true.
`source` / `--source`	cadena; valores: `default`, `google`, `outdoor`	No	default	Colección default, google u outdoor; disponibilidad según región.
`width` / `--width`	entero; 1–640	No	640	Ancho de imagen, 1–640 píxeles, solo para image. No incluye tamaños especiales Google.

Comportamiento y restricciones

Indique exactamente location o panoId. width, height, heading, fov, pitch y returnErrorCode son solo para image; se rechazan campos no usados.
Los metadatos son actualmente gratuitos y no consumen cuota de imágenes; las imágenes se facturan. https://developers.google.com/maps/documentation/streetview/metadata
Conserve la atribución integrada. No se permite uso impreso; rigen restricciones de almacenamiento/caché. Esta herramienta no concede derechos para conservar, redistribuir o analizar. https://developers.google.com/maps/documentation/streetview/policies
La firma indicada se transmite, no se genera. No se implementan imágenes de tamaño especial ni configuración de clave de firma. https://developers.google.com/maps/documentation/streetview/request-streetview
Varían cobertura y condiciones EEE; los ID de panorama y fechas pueden cambiar o faltar.

Fuentes primarias: 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

Resultado

Metadatos nativos con status, date, location, pano_id y copyright disponibles, o bytes JPEG con MIME y caché HTTP segura. La imagen ausente genera error por defecto. CLI --output guarda bytes; MCP muestra imagen y metadatos.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_streetview_publish

Gestionar fotos y secuencias del usuario Google que dio consentimiento con todos los métodos REST v1 documentados y carga de medios limitada. Publicaciones y borrados son explícitos y nunca se reintentan automáticamente.

Comando CLI: streetview-publish. Acceso Google: Solo OAuth de usuario final con https://www.googleapis.com/auth/streetviewpublish. Use un archivo authorized_user explícito en GOOGLE_APPLICATION_CREDENTIALS y modo OAuth. Se rechazan cuenta de servicio, ADC implícito y clave API por sí solos. Configure aparte el consentimiento; el ejecutable renueva tokens pero no aloja callback del navegador.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`dataBase64` / `--data-base64`	cadena; al menos 4 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	Bytes en base64 estándar con relleno; tamaño decodificado de 1 byte a 8 MiB, límite de esta herramienta y no de Google.
`filter` / `--filter`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	Expresión de filtro Google para list/list_sequences/get_sequence; gramática específica del método.
`inputType` / `--input-type`	cadena; valores: `VIDEO`, `XDM`	No	No indicado; obligatorio para las operaciones descritas	VIDEO o XDM, obligatorio para create_sequence.
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	Valor Google	Idioma preferido para list/get/batch_get.
`mimeType` / `--mime-type`	cadena; valores: `image/jpeg`, `application/octet-stream`, `video/mp4`	No	image/jpeg	Tipo de medio cargado: image/jpeg, video/mp4 o application/octet-stream.
`operation` / `--operation`	cadena; valores: `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 o delete_sequence.
`pageSize` / `--page-size`	entero; 1–100	No	Valor del servicio Google	Tamaño de página solicitado, 1–100, para list/list_sequences; Google puede devolver menos.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	nextPageToken opaco de la página anterior; paginación explícita.
`photo` / `--photo`	objeto	No	No indicado; obligatorio para las operaciones descritas	JSON Photo Google para create/update. create exige uploadReference.uploadUrl tras cargar; update exige photoId separado y updateMask. https://developers.google.com/streetview/publish/reference/rest/v1/photo
`photoId` / `--photo-id`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	ID de foto para get/update/delete, sin ruta ni parámetros URL.
`photoIds` / `--photo-ids`	array de cadenas; 1–100 elementos; cada elemento al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	De 1 a 100 ID para batch_get/batch_delete.
`photoSequence` / `--photo-sequence`	objeto	No	No indicado; obligatorio para las operaciones descritas	JSON PhotoSequence para create_sequence con uploadReference.uploadUrl y metadatos GPS/CAMM/IMU/captura exigidos por formato. https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create
`sequenceId` / `--sequence-id`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	ID de secuencia para get_sequence/delete_sequence; el nombre de operación de creación lo contiene.
`updateMask` / `--update-mask`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	FieldMask obligatorio para update, por ejemplo pose.heading o pose.latLngPair.
`updatePhotoRequests` / `--update-photo-requests`	array de objetos; 1–100 elementos	No	No indicado; obligatorio para las operaciones descritas	De 1 a 100 objetos nativos UpdatePhotoRequest; cada uno exige photo.photoId.id y updateMask.
`uploadUrl` / `--upload-url`	cadena; al menos 1 carácter(es)	No	No indicado; obligatorio para las operaciones descritas	URL HTTPS UploadRef exacta de start_upload/start_sequence_upload; solo streetviewpublish.googleapis.com/media/user/{account}/photo/{reference} o photoSequence, sin redirección, otro origen, usuario, fragmento ni segmentos codificados.
`view` / `--view`	cadena; valores: `BASIC`, `INCLUDE_DOWNLOAD_URL`	No	BASIC	BASIC o INCLUDE_DOWNLOAD_URL para list/get/batch_get/get_sequence. No se descargan URL privadas.

Comportamiento y restricciones

Flujo foto: start_upload → upload con dataBase64 → create con photo.uploadReference.uploadUrl y metadatos obligatorios. La carga sola no publica. Las imágenes deben cumplir Photo Sphere 360/XMP y los criterios Google. https://developers.google.com/streetview/publish/first-app
update usa PUT y updateMask; Google no permite cambiar píxeles. delete/batch_delete eliminan fotos publicadas. doctor y pruebas en vivo no cargan, publican ni borran.
Flujo secuencia: start_sequence_upload → upload → create_sequence(inputType, photoSequence) → get_sequence. Los vídeos suelen superar 8 MiB; no hay cargas reanudables ni fragmentadas. Cargue archivos grandes externamente con Google y pase UploadRef.
Los objetos GPS, pose, IMU, conexiones y lugares usan esquemas Google. Se rechazan campos externos desconocidos; Google valida detalles nativos. Cada batch_update requiere photo.photoId.id y updateMask.
Métodos documentados cubiertos: photo create/delete/get/startUpload/update; photos list/batchGet/batchUpdate/batchDelete; photoSequence create/delete/get/startUpload; photoSequences list. No se ha probado en vivo cada campo nativo. https://developers.google.com/streetview/publish/reference/rest
Las cargas están limitadas, usan host fijo y no se reintentan. Todas las mutaciones desactivan reintentos para evitar cambios públicos duplicados. Revise los resultados.
Rigen consentimiento, propiedad, privacidad, copyright, aceptación 360 y cuotas Google; IAM de cuenta de servicio no sustituye el consentimiento. No se probó publicación en vivo con la cuenta de servicio suministrada. https://developers.google.com/streetview/publish/authorizing

Fuentes primarias: 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

Resultado

JSON Google nativo Photo, listas/páginas, UploadRef, lotes u operaciones largas. Las respuestas vacías de carga/borrado son {}. Conserva estados y propiedad. Consulte secuencias con get_sequence; no hay consultas ni publicación automáticas.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_datasets

Gestionar conjuntos geográficos para estilos de Google Maps basados en datos, incluida importación asíncrona desde un objeto Cloud Storage existente.

Comando CLI: datasets. Acceso Google: Solo OAuth 2.0 mediante cuenta de servicio o ADC con https://www.googleapis.com/auth/cloud-platform. No se aceptan claves API. Configure por separado permisos de proyectos de recurso y cuota.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`dataset` / `--dataset`	objeto	No	Obligatorio para create/update	JSON Dataset nativo para create/update. create exige displayName único y usage:["USAGE_DATA_DRIVEN_STYLING"]. update envía metadatos con el nombre de recurso correspondiente.
`gcsSource` / `--gcs-source`	objeto	No	Obligatorio para import	Origen Cloud Storage de importación ya accesible al cliente; no se leen archivos locales.
`gcsSource.fileFormat`	cadena; valores: `FILE_FORMAT_GEOJSON`, `FILE_FORMAT_KML`, `FILE_FORMAT_CSV`	Si se proporciona el objeto padre	Obligatorio con gcsSource	Codificación FILE_FORMAT_GEOJSON, FILE_FORMAT_KML o FILE_FORMAT_CSV.
`gcsSource.inputUri`	cadena; al menos 1 carácter(es)	Si se proporciona el objeto padre	Obligatorio con gcsSource	URI existente gs://bucket/object; requiere storage.objects.get, por ejemplo Storage Object Viewer.
`name` / `--name`	cadena; patrón: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$`	No	Obligatorio para operaciones de recurso	projects/{project}/datasets/{dataset}, obligatorio salvo list/create. get también admite @active para la última versión completada.
`operation` / `--operation`	cadena; valores: `list`, `get`, `create`, `update`, `delete`, `import`, `download`, `fetch_errors`	Sí	Obligatorio	list, get, create, update, delete, import, download o fetch_errors. create/update/delete/import modifican recursos cloud.
`pageSize` / `--page-size`	entero; 1–500	No	list: 100; fetch_errors: Google 50	Máximo de conjuntos/errores por página; de 1 a 500 en esta herramienta.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	Token de la página list/fetch_errors anterior; conserve los demás argumentos.
`parent` / `--parent`	cadena; patrón: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$`	No	Obligatorio para list/create	projects/{ID o número del proyecto}, obligatorio para list/create.
`tag` / `--tag`	cadena; valores: `active`	No	Última versión sin importar el estado	Para list, active devuelve la última versión completada y omite conjuntos sin ella.
`updateMask` / `--update-mask`	cadena; al menos 1 carácter(es)	No	Google usa * (sustitución completa de metadatos)	Rutas de metadatos separadas por comas para update, por ejemplo description,displayName.
`versionDescription` / `--version-description`	cadena; al menos 1 carácter(es)	No	Omitido	Descripción de la nueva versión, solo para import.

Comportamiento y restricciones

El esquema y permisos dependen de la operación: mapsplatformdatasets.datasets.list/get/create/update/delete/import/export. https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets
La importación GCS crea una versión asíncrona. Consulte estado con get y errores con fetch_errors; no hay consultas automáticas. https://developers.google.com/maps/documentation/datasets/create
REST v1 público no documenta listVersions. Use get para la última versión, get con @active y versionId; no se promete historial completo.
download requiere mapsplatformdatasets.datasets.export; CLI --output escribe bytes. https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download
Maps Datasets no cobra por uso, pero exige proyecto configurado; Google Maps y Cloud Storage pueden tener cargos propios. Uso previsto: estilos basados en datos. No hay carga local multipart; use un objeto GCS existente. https://developers.google.com/maps/documentation/datasets/overview

Fuentes primarias: 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

Resultado

JSON nativo Dataset/listas/errores, nombre de versión importada o bytes descargados con MIME/caché. get conserva status.state, status.errorMessage y versionId; importar no implica procesamiento terminado.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_route_optimization

Optimizar flotas de reparto o servicio con Route Optimization y ShipmentModel nativo completo: capacidades, ventanas temporales y costes.

Comando CLI: route-optimization. Acceso Google: Solo OAuth 2.0 mediante cuenta de servicio o ADC con https://www.googleapis.com/auth/cloud-platform. No se aceptan claves API. Configure por separado permisos de proyectos de recurso y cuota.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`name` / `--name`	cadena; patrón: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$`	No	Obligatorio para get_operation	Nombre exacto Google projects/{project}[/locations/{location}]/operations/{ID}, para get_operation.
`operation` / `--operation`	cadena; valores: `optimize`, `validate`, `batch`, `optimize_long_running`, `optimize_uri`, `get_operation`	Sí	Obligatorio	optimize resuelve síncronamente; validate fija VALIDATE_ONLY; batch crea trabajo GCS; optimize_long_running/optimize_uri son experimentales; get_operation consulta estado.
`parent` / `--parent`	cadena; patrón: `^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$`	No	Obligatorio salvo get_operation	projects/{ID}, opcionalmente /locations/-. Optimización síncrona/larga rechaza regiones concretas; lote/URI admiten la forma nativa.
`request` / `--request`	objeto	No	Obligatorio salvo get_operation	Cuerpo nativo completo sin parent. optimize/validate/optimize_long_running requieren model con shipments/vehicles y restricciones. batch: 1–100 modelConfigs, inputConfig.gcsSource.uri, outputConfig.gcsDestination.uri, JSON/PROTO_TEXT. URI: input.uri/output.uri gs:// con .json/.txtpb.

Comportamiento y restricciones

validate también llama a Google y no resuelve el modelo. Esquema nativo: https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours
Habilite la API. roles/routeoptimization.viewer permite OptimizeTours y lectura; editor añade lotes. Permisos: routeoptimization.locations.use y routeoptimization.operations.create/get. https://developers.google.com/maps/documentation/route-optimization/cloud-setup
Los lotes leen/escriben GCS: indique URI y permisos de almacenamiento. Los trabajos pueden continuar tras la llamada. Sin carga de archivos ni consultas automáticas. https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours
Las variantes largas y URI son experimentales; URI usa exactamente :OptimizeToursUri. El comportamiento previo a disponibilidad general puede cambiar. https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto
Google no admite actualmente cancel/delete/list de operaciones; solo se expone get_operation, sin garantía de cancelación. https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations
Facturación según envíos y SKU Single Vehicle/Fleet Routing, distinta de optimización de puntos Routes. Un timeout de transporte no cancela trabajos. https://developers.google.com/maps/documentation/route-optimization/usage-and-billing

Fuentes primarias: 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

Resultado

OptimizeToursResponse nativa u Operation larga. Las consultas conservan done:false, metadata y objetos finales response/error sin ocultar fallos.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Consultar previsiones horarias de calidad del aire para un instante o intervalo, hasta 96 horas.

Comando CLI: air-quality-forecast. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`customLocalAqis` / `--custom-local-aqis`	array de objetos; 1–250 elementos	No	Google selecciona índices locales	Sustituir el índice local de ciertos códigos ISO de país/región.
`customLocalAqis[].aqi`	cadena; al menos 1 carácter(es)	Si se proporciona el objeto padre	Obligatorio para cada sustitución	Código AQI local compatible, por ejemplo us_epa; Google valida las combinaciones.
`customLocalAqis[].regionCode`	cadena; patrón: `^[A-Za-z]{2}$`	Si se proporciona el objeto padre	Obligatorio para cada sustitución	Código de país/región de dos letras afectado.
`dateTime` / `--date-time`	cadena; al menos 20 carácter(es)	No	Elegir un selector temporal	Marca UTC RFC3339 terminada en Z, redondeada a la hora anterior. Incompatible con period/hours.
`extraComputations` / `--extra-computations`	array de cadenas; 1–5 elementos; valores: `LOCAL_AQI`, `HEALTH_RECOMMENDATIONS`, `POLLUTANT_ADDITIONAL_INFO`, `DOMINANT_POLLUTANT_CONCENTRATION`, `POLLUTANT_CONCENTRATION`	No	Sin cálculos adicionales	Solicitar LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION y/o POLLUTANT_CONCENTRATION.
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	Google: en	Idioma IETF del texto; Google elige el idioma compatible más cercano.
`location` / `--location`	objeto	Sí	Obligatorio	Ubicación de las condiciones solicitadas.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud en grados, de -90 a 90.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud en grados, de -180 a 180.
`pageSize` / `--page-size`	entero; 1–96	No	Google: previsión 24; historial 72	Registros horarios máximos por página: previsión hasta 96, historial hasta 168.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	nextPageToken anterior; conserve los demás argumentos.
`period` / `--period`	objeto	No	Elegir un selector temporal	Intervalo horario inclusivo ordenado, máximo 96 h de previsión o 720 h históricas. Incompatible con dateTime/hours.
`period.endTime`	cadena; al menos 20 carácter(es)	Si se proporciona el objeto padre	Obligatorio con period	Fin inclusivo RFC3339 UTC terminado en Z.
`period.startTime`	cadena; al menos 20 carácter(es)	Si se proporciona el objeto padre	Obligatorio con period	Inicio RFC3339 UTC válido terminado en Z.
`uaqiColorPalette` / `--uaqi-color-palette`	cadena; valores: `RED_GREEN`, `INDIGO_PERSIAN_DARK`, `INDIGO_PERSIAN_LIGHT`	No	Paleta Google	Paleta universal RED_GREEN, INDIGO_PERSIAN_DARK o INDIGO_PERSIAN_LIGHT. Las paletas locales son fijas.
`universalAqi` / `--universal-aqi`	booleano	No	Google: true	Incluir el índice universal de calidad del aire.

Comportamiento y restricciones

Referencia: https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup
Se requiere exactamente un selector temporal. Sintaxis, orden y duración máxima se validan localmente; Google valida disponibilidad actual y cobertura.
Una página por llamada; siga nextPageToken explícitamente. Se conservan índices, concentraciones, recomendaciones y región.
Respete atribución, visualización y caché. Cobertura e índices locales varían. https://developers.google.com/maps/documentation/air-quality/policies

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

Resultado

Colección nativa hourlyForecasts, regionCode y nextPageToken con contaminantes y recomendaciones disponibles.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Consultar la calidad del aire de los últimos 30 días.

Comando CLI: air-quality-history. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`customLocalAqis` / `--custom-local-aqis`	array de objetos; 1–250 elementos	No	Google selecciona índices locales	Sustituir el índice local de ciertos códigos ISO de país/región.
`customLocalAqis[].aqi`	cadena; al menos 1 carácter(es)	Si se proporciona el objeto padre	Obligatorio para cada sustitución	Código AQI local compatible, por ejemplo us_epa; Google valida las combinaciones.
`customLocalAqis[].regionCode`	cadena; patrón: `^[A-Za-z]{2}$`	Si se proporciona el objeto padre	Obligatorio para cada sustitución	Código de país/región de dos letras afectado.
`dateTime` / `--date-time`	cadena; al menos 20 carácter(es)	No	Elegir un selector temporal	Marca UTC RFC3339 terminada en Z, redondeada a la hora anterior. Incompatible con period/hours.
`extraComputations` / `--extra-computations`	array de cadenas; 1–5 elementos; valores: `LOCAL_AQI`, `HEALTH_RECOMMENDATIONS`, `POLLUTANT_ADDITIONAL_INFO`, `DOMINANT_POLLUTANT_CONCENTRATION`, `POLLUTANT_CONCENTRATION`	No	Sin cálculos adicionales	Solicitar LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION y/o POLLUTANT_CONCENTRATION.
`hours` / `--hours`	entero; 1–720	No	Elegir exactamente hours, dateTime o period	Horas anteriores, de 1 a 720 (30 días), incompatible con dateTime/period.
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	Google: en	Idioma IETF del texto; Google elige el idioma compatible más cercano.
`location` / `--location`	objeto	Sí	Obligatorio	Ubicación de las condiciones solicitadas.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud en grados, de -90 a 90.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud en grados, de -180 a 180.
`pageSize` / `--page-size`	entero; 1–168	No	Google: previsión 24; historial 72	Registros horarios máximos por página: previsión hasta 96, historial hasta 168.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	nextPageToken anterior; conserve los demás argumentos.
`period` / `--period`	objeto	No	Elegir un selector temporal	Intervalo horario inclusivo ordenado, máximo 96 h de previsión o 720 h históricas. Incompatible con dateTime/hours.
`period.endTime`	cadena; al menos 20 carácter(es)	Si se proporciona el objeto padre	Obligatorio con period	Fin inclusivo RFC3339 UTC terminado en Z.
`period.startTime`	cadena; al menos 20 carácter(es)	Si se proporciona el objeto padre	Obligatorio con period	Inicio RFC3339 UTC válido terminado en Z.
`uaqiColorPalette` / `--uaqi-color-palette`	cadena; valores: `RED_GREEN`, `INDIGO_PERSIAN_DARK`, `INDIGO_PERSIAN_LIGHT`	No	Paleta Google	Paleta universal RED_GREEN, INDIGO_PERSIAN_DARK o INDIGO_PERSIAN_LIGHT. Las paletas locales son fijas.
`universalAqi` / `--universal-aqi`	booleano	No	Google: true	Incluir el índice universal de calidad del aire.

Comportamiento y restricciones

Referencia: https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup
Se requiere exactamente un selector temporal. Sintaxis, orden y duración máxima se validan localmente; Google valida disponibilidad actual y cobertura.
Una página por llamada; siga nextPageToken explícitamente. Se conservan índices, concentraciones, recomendaciones y región.
Respete atribución, visualización y caché. Cobertura e índices locales varían. https://developers.google.com/maps/documentation/air-quality/policies

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

Resultado

Colección nativa hoursInfo, regionCode y nextPageToken con contaminantes y recomendaciones disponibles.

Ejemplo

Argumentos MCP:

json

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

Llamada 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

Descargar una tesela de mapa de calor de calidad del aire para un índice o contaminante.

Comando CLI: air-quality-heatmap. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`mapType` / `--map-type`	cadena; valores: `UAQI_RED_GREEN`, `UAQI_INDIGO_PERSIAN`, `PM25_INDIGO_PERSIAN`, `GBR_DEFRA`, `DEU_UBA`, `CAN_EC`, `FRA_ATMO`, `US_AQI`	Sí	Obligatorio	Índice/contaminante: UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO o US_AQI.
`x` / `--x`	entero; 0–65535	Sí	Obligatorio	Columna, de 0 a 2^zoom−1; límites verificados antes de llamar.
`y` / `--y`	entero; 0–65535	Sí	Obligatorio	Fila, de 0 a 2^zoom−1; límites verificados antes de llamar.
`zoom` / `--zoom`	entero; 0–16	Sí	Obligatorio	Zoom Web Mercator de 0 a 16; una tesela en nivel cero.

Comportamiento y restricciones

Cobertura según país, índice y temporada. https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile
Respete atribución, reglas de visualización y límites de almacenamiento/caché; se conservan cabeceras, sin conceder licencia. https://developers.google.com/maps/documentation/air-quality/policies

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

Resultado

Bytes de tesela con MIME y metadatos de caché Google; MCP muestra la imagen y CLI --output escribe bytes.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_pollen_heatmap

Descargar una tesela de índice de polen de árboles, gramíneas o malezas.

Comando CLI: pollen-heatmap. Acceso Google: Clave API, Pollen y facturación habilitados; este ejecutable no admite OAuth de cuenta de servicio para Pollen.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`mapType` / `--map-type`	cadena; valores: `TREE_UPI`, `GRASS_UPI`, `WEED_UPI`	Sí	Obligatorio	TREE_UPI, GRASS_UPI o WEED_UPI.
`x` / `--x`	entero; 0–65535	Sí	Obligatorio	Columna, de 0 a 2^zoom−1; límites verificados antes de llamar.
`y` / `--y`	entero; 0–65535	Sí	Obligatorio	Fila, de 0 a 2^zoom−1; límites verificados antes de llamar.
`zoom` / `--zoom`	entero; 0–16	Sí	Obligatorio	Zoom Web Mercator de 0 a 16; una tesela en nivel cero.

Comportamiento y restricciones

Cobertura según país, índice y temporada. https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile
Respete atribución, reglas de visualización y límites de almacenamiento/caché; se conservan cabeceras, sin conceder licencia. https://developers.google.com/maps/documentation/pollen/policies

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

Resultado

Bytes de tesela con MIME y metadatos de caché Google; MCP muestra la imagen y CLI --output escribe bytes.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_weather_history

Consultar hasta 24 horas anteriores de meteorología con paginación explícita.

Comando CLI: weather-history. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`hours` / `--hours`	entero; 1–24	No	Google: 24	Horas anteriores a partir de la última hora, de 1 a 24.
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	Google: en	Idioma de respuesta IETF BCP-47 si está disponible.
`location` / `--location`	objeto	Sí	Obligatorio	Ubicación de las condiciones solicitadas.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud en grados, de -90 a 90.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud en grados, de -180 a 180.
`pageSize` / `--page-size`	entero; 1–24	No	Historial: Google 24; otros: valor Google	Máximo por página: historial 1–24, alertas/previsión por minutos 1–1000 en esta herramienta.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	nextPageToken anterior; conserve los demás argumentos.
`unitsSystem` / `--units-system`	cadena; valores: `METRIC`, `IMPERIAL`	No	Google: METRIC	Unidades METRIC o IMPERIAL, especialmente para precipitación.

Comportamiento y restricciones

Solo las últimas 24 horas, no fechas históricas arbitrarias. https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup
Respete cobertura y políticas meteorológicas; sin páginas automáticas. https://developers.google.com/maps/documentation/weather/policies

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

Resultado

historyHours, timeZone y nextPageToken nativos con condiciones horarias.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_weather_alerts

Consultar alertas meteorológicas públicas de una ubicación con gravedad y autoridad emisora nativas.

Comando CLI: weather-alerts. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`languageCode` / `--language-code`	cadena; al menos 1 carácter(es)	No	Google: en	Idioma de respuesta IETF BCP-47 si está disponible.
`location` / `--location`	objeto	Sí	Obligatorio	Ubicación de las condiciones solicitadas.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud en grados, de -90 a 90.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud en grados, de -180 a 180.
`pageSize` / `--page-size`	entero; 1–1000	No	Historial: Google 24; otros: valor Google	Máximo por página: historial 1–24, alertas/previsión por minutos 1–1000 en esta herramienta.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	nextPageToken anterior; conserve los demás argumentos.

Comportamiento y restricciones

Cobertura, demora y campos dependen de la autoridad emisora. https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup
Conserve atribuciones de proveedores. La ausencia de alertas no garantiza seguridad. https://developers.google.com/maps/documentation/weather/policies

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

Resultado

weatherAlerts, autoridades/zonas y nextPageToken nativos si están disponibles.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_weather_minute_forecast

EXPERIMENTAL: obtener previsión de precipitación de alta resolución para seis horas.

Comando CLI: weather-minute-forecast. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`location` / `--location`	objeto	Sí	Obligatorio	Ubicación de las condiciones solicitadas.
`location.latitude`	número; -90.0–90.0	Si se proporciona el objeto padre	Obligatorio con location	Latitud en grados, de -90 a 90.
`location.longitude`	número; -180.0–180.0	Si se proporciona el objeto padre	Obligatorio con location	Longitud en grados, de -180 a 180.
`pageSize` / `--page-size`	entero; 1–1000	No	Historial: Google 24; otros: valor Google	Máximo por página: historial 1–24, alertas/previsión por minutos 1–1000 en esta herramienta.
`pageToken` / `--page-token`	cadena; al menos 1 carácter(es)	No	Primera página	nextPageToken anterior; conserve los demás argumentos.
`unitsSystem` / `--units-system`	cadena; valores: `METRIC`, `IMPERIAL`	No	Google: METRIC	Unidades METRIC o IMPERIAL, especialmente para precipitación.

Comportamiento y restricciones

Experimental/previo a disponibilidad general: soporte limitado y posibles cambios incompatibles. https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map
Atribución obligatoria. Google limita la caché de estas previsiones/teselas a una hora; después debe eliminarse el contenido.
Google prohíbe recrear un servicio/producto Google con este contenido, incluidas aplicaciones o modelos cuyo fin principal sea meteorología. Las restricciones también afectan a consumidores posteriores.
Las previsiones por minutos y teselas pueden no estar sincronizadas. Una página por llamada; disponibilidad según lugar y acceso.

Fuentes primarias: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Resultado

overallPredictionTimeframe, timeZone, segments y nextPageToken nativos; conserva tipos, probabilidades, cantidades e intensidad.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

maps_weather_map

EXPERIMENTAL: descargar una tesela de precipitación inmediata para Estados Unidos o Europa.

Comando CLI: weather-map. Acceso Google: Clave API u OAuth 2.0 cloud-platform; habilite API y facturación. Con OAuth, la identidad del proyecto de cuota necesita serviceusage.services.use.

Parámetros

Parámetro / opción CLI	Tipo y límites del esquema	Obligatorio	Valor si se omite	Descripción
`mapType` / `--map-type`	cadena; valores: `US_PRECIPITATION_CURRENT`, `EU_PRECIPITATION_CURRENT`	Sí	Obligatorio	US_PRECIPITATION_CURRENT o EU_PRECIPITATION_CURRENT según región cubierta.
`x` / `--x`	entero; 0–65535	Sí	Obligatorio	Columna, de 0 a 2^zoom−1; límites verificados antes de llamar.
`y` / `--y`	entero; 0–65535	Sí	Obligatorio	Fila, de 0 a 2^zoom−1; límites verificados antes de llamar.
`zoom` / `--zoom`	entero; 0–16	Sí	Obligatorio	Zoom Web Mercator de 0 a 16; una tesela en nivel cero.

Comportamiento y restricciones

Experimental/previo a disponibilidad general: soporte limitado y posibles cambios incompatibles. https://developers.google.com/maps/documentation/weather/minute-forecast ; https://developers.google.com/maps/documentation/weather/weather-map
Atribución obligatoria. Google limita la caché de estas previsiones/teselas a una hora; después debe eliminarse el contenido.
Google prohíbe recrear un servicio/producto Google con este contenido, incluidas aplicaciones o modelos cuyo fin principal sea meteorología. Las restricciones también afectan a consumidores posteriores.
Cobertura EE. UU./Europa limitada a la guía; coordenadas válidas de tesela no garantizan datos.

Fuentes primarias: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

Resultado

Bytes de tesela con MIME y metadatos de caché Google; MCP muestra la imagen y CLI --output escribe bytes.

Ejemplo

Argumentos MCP:

json

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

Llamada CLI equivalente:

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

Referencia de herramientas ​

Convenciones de llamada ​

Herramientas ​

maps_geocode ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_validate_address ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_pollen ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_area_insights ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_snap_to_roads ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_nearest_roads ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_reverse_geocode ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_search_places ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_search_nearby ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_place_details ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_directions ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_distance_matrix ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_elevation ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_timezone ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_weather ​

Parámetros ​

Comportamiento y restricciones ​

Resultado ​

Ejemplo ​

maps_air_quality ​

Parámetros ​

Referencia de herramientas

Convenciones de llamada

Herramientas

maps_geocode

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_validate_address

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_pollen

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_area_insights

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_snap_to_roads

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_nearest_roads

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_reverse_geocode

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_search_places

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_search_nearby

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_place_details

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_directions

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_distance_matrix

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_elevation

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_timezone

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_weather

Parámetros

Comportamiento y restricciones

Resultado

Ejemplo

maps_air_quality

Parámetros