Receber mapas de clima (experimental)

O endpoint mapTypes fornece blocos de mapas rasterizados que representam vários fenômenos climáticos, como previsões de precipitação. Esses blocos podem ser sobrepostos ao Google Maps padrão.

.

Termos

Estes termos são emitidos de acordo com a Seção 6 (Termos de produtos e recursos em pré-GA) dos Termos de Serviço Específicos da Plataforma Google Maps, conforme acordado entre o Google e você.

1.1 Requisitos de atribuição. O Cliente precisa fornecer ao Google a atribuição de acordo com a Documentação se usar o Conteúdo do Google Maps da API Weather.

1.2 Restrições. Os clientes não podem usar o Conteúdo do Google Maps recuperado da API Weather para recriar um serviço ou produto do Google (por exemplo, usar dados recuperados da API Weather em um app ou modelo de clima cujo objetivo principal é fornecer informações meteorológicas).

1.3 Armazenamento em cache. Os clientes podem armazenar temporariamente em cache o Conteúdo do Google Maps aplicável da API Weather durante o Período de armazenamento em cache aplicável, conforme descrito na Tabela 1.3.1 (Permissões de armazenamento em cache).

Tabela 1.3.1 (permissões de armazenamento em cache)

Essas permissões são adicionais às descritas na Tabela 17.2.1 dos Termos de Serviço específicos da Plataforma Google Maps.

Conteúdo do Google Maps Período de armazenamento em cache
Blocos de mapa do clima Uma hora, após a qual o Cliente precisa excluir o Conteúdo do Google Maps armazenado em cache

Sobre as solicitações de mapas meteorológicos

Para solicitar mapas meteorológicos, envie uma solicitação GET HTTP para:

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

Tipos de mapa

A API Weather é compatível com diferentes tipos de mapas do clima, que correspondem a modelos climáticos e áreas geográficas diferentes:

  • US_PRECIPITATION_CURRENT: previsão imediata de alta resolução de precipitação nos Estados Unidos.
  • EU_PRECIPITATION_CURRENT: previsão imediata de precipitação de alta resolução na Europa.

O mapa de cobertura abaixo mostra as regiões em que os blocos do mapa do clima estão disponíveis:

Cobertura de blocos de mapas do clima

Sistema de coordenadas de blocos

A API usa o sistema padrão de coordenadas de bloco Web Mercator. Para uma explicação abrangente sobre coordenadas de mapa e coordenadas de bloco, consulte Blocos de mapa de ruas e Coordenadas de mapa e coordenadas de bloco.

Neste sistema:

  • zoom: o nível de zoom (0 a 16). O nível de zoom 0 representa o mundo inteiro em um único bloco (20 x 20 = 1 bloco). O nível de zoom z divide o mundo em uma grade de 2z x 2z blocos.
  • x: a coordenada X (coluna) do bloco, que varia de 0 (mais a oeste) a 2zoom - 1 (mais a leste).
  • y: a coordenada Y (linha) do bloco, que varia de 0 (mais ao norte) a 2zoom - 1 (mais ao sul).

Mostrar mapa do clima

Para mostrar esses blocos em um aplicativo da Web usando a API Google Maps JavaScript, crie um 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);

Exemplo de solicitação de mapa do clima

O exemplo a seguir solicita blocos de mapa de precipitação dos EUA para Nova Orleans:

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

A resposta é binária. O wrapper JSON só aparece em configurações de serialização específicas, como ?alt=json.