El extremo mapTypes proporciona mosaicos de mapas de trama que representan diversos fenómenos meteorológicos, como los pronósticos de precipitación. Estos mosaicos del mapa se pueden superponer en el mapa estándar de Google Maps.
Condiciones
Estas condiciones se emiten en virtud del Artículo 6 (Condiciones de las Ofertas Previas a la DG) de las Condiciones Específicas del Servicio de Google Maps Platform, según lo acordado entre Google y usted.
1.1 Requisitos de Atribución. El Cliente debe proporcionar a Google la atribución de conformidad con la Documentación si utiliza 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 un modelo meteorológico cuyo propósito principal sea proporcionar información sobre el clima).
1.3 Almacenamiento en caché. Los clientes pueden almacenar en caché de forma temporal 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 la Tabla 17.2.1 de las Condiciones Específicas de los Servicios de Google Maps Platform.
| Contenido de Google Maps | Período de almacenamiento en caché |
|---|---|
| Mosaicos del mapa 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 HTTP a la siguiente URL:
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 climáticos subyacentes y áreas geográficas:
US_PRECIPITATION_CURRENT: Pronóstico inmediato de precipitación de alta resolución para Estados Unidos.EU_PRECIPITATION_CURRENT: Pronóstico inmediato de precipitación de alta resolución para Europa.
En el siguiente mapa de cobertura, se muestran las regiones en las que están disponibles las tarjetas del mapa del clima:
Sistema de coordenadas de mosaicos
La API usa el sistema de coordenadas de la Web Mercator estándar. Para obtener una explicación completa de las coordenadas de mapas y mosaicos, consulta Mosaicos de mapas de rutas y Coordenadas de mapas y mosaicos.
En este sistema, sucede lo siguiente:
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) de la segmentación, que va de 0 (la más occidental) a 2zoom - 1 (la más oriental).y: Es la coordenada Y (fila) de la segmentación, que va de 0 (la más al norte) a 2zoom - 1 (la más al sur).
Mostrar mapa del clima
Para mostrar estos mosaicos en una aplicación web con la API de Google 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 del mapa del clima de precipitaciones 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 con parámetros de configuración de serialización específicos, como ?alt=json.