El extremo mapTypes proporciona mosaicos de mapas ráster que representan varios fenómenos meteorológicos, como los pronósticos de precipitación. Estos mosaicos de mapas se pueden superponer en Google Maps estándar.
Condiciones
Estas condiciones se emiten en virtud del Artículo 6 (Condiciones de las ofertas anteriores a la disponibilidad general) de las Condiciones Específicas del Servicio de Google Maps Platform, según lo acordado por Google y tú.
1.1 Requisitos de atribución. El Cliente debe proporcionar a Google la atribución de acuerdo con la Documentación si usa Contenido de Google Maps de la API de Weather.
1.2 Restricciones. Los clientes no pueden usar el Contenido de Google Maps recuperado de la API de Weather para recrear un servicio o producto de Google (p.ej., usar datos recuperados de la API de Weather en una app o modelo del clima cuyo objetivo principal sea proporcionar información meteorológica).
1.3 Almacenamiento en caché. Los clientes pueden almacenar en caché temporalmente el Contenido de Google Maps aplicable de la API de Weather durante el Período de Almacenamiento en Caché aplicable, como se describe en la Tabla 1.3.1 (Permisos de Almacenamiento en Caché).
Tabla 1.3.1 (Permisos de Almacenamiento en Caché)
Estos permisos se suman a los que se describen en Tabla 17.2.1 de las Condiciones Específicas del Servicio de Google Maps Platform.
| Contenido de Google Maps | Período de Almacenamiento en Caché |
|---|---|
| Mosaicos de mapas del clima | Una hora, después de la cual el Cliente debe borrar el Contenido de Google Maps almacenado en caché |
Acerca de las solicitudes de mapas del clima
Para solicitar mapas del clima, envía una solicitud GET a:
https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}Tipos de mapas
La API de Weather admite diferentes tipos de mapas del clima, que corresponden a diferentes modelos meteorológicos subyacentes y áreas geográficas:
US_PRECIPITATION_CURRENT: Pronóstico inmediato de precipitación de alta resolución de Estados Unidos.EU_PRECIPITATION_CURRENT: Pronóstico inmediato de precipitación de alta resolución de Europa.
En el siguiente mapa de cobertura, se muestran las regiones en las que están disponibles los mosaicos de mapas del clima:
Sistema de coordenadas de mosaicos
La API usa el sistema de coordenadas de mosaicos de Web Mercator estándar. Para obtener una explicación completa de las coordenadas de mapas y mosaicos, consulta Mosaicos de mapas viales y Coordenadas de mapas y mosaicos.
En este sistema:
zoom: Es el nivel de zoom (de 0 a 16). El nivel de zoom 0 representa el mundo entero en un solo mosaico (20 x 20 = 1 mosaico). El nivel de zoom z divide el mundo en una cuadrícula de mosaicos de 2z x 2z.x: Es la coordenada X (columna) del mosaico, que va de 0 (más occidental) a 2zoom - 1 (más oriental).y: Es la coordenada Y (fila) del mosaico, que va de 0 (más septentrional) a 2zoom - 1 (más meridional).
Cómo mostrar el mapa del clima
Para mostrar estos mosaicos en una aplicación web con la API de Maps JavaScript, puedes crear un google.maps.ImageMapType personalizado:
const weatherMapType = new google.maps.ImageMapType({ getTileUrl: function(coord, zoom) { const mapType = "US_PRECIPITATION_CURRENT"; return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`; }, tileSize: new google.maps.Size(256, 256), maxZoom: 16, minZoom: 0, name: "Weather" }); // Overlay on existing map map.overlayMapTypes.insertAt(0, weatherMapType);
Ejemplo de solicitud de mapa del clima
En el siguiente ejemplo, se solicitan mosaicos de mapas del clima de precipitación de EE.UU. para Nueva Orleans:
curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"
La respuesta es binaria. El wrapper de JSON solo aparece en parámetros de configuración de serialización específicos, como ?alt=json.