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

Esses termos são emitidos de acordo com a seção 6 (Termos de ofertas 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 atribuição ao Google 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, não é permitido usar dados recuperados da API Weather em um app ou modelo climático cuja finalidade principal seja fornecer informações sobre o clima.

1.3 Armazenamento em cache. Os clientes podem armazenar temporariamente em cache o conteúdo aplicável do Google Maps 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 mapas climáticos Uma hora, após a qual o cliente precisa excluir o conteúdo do Google Maps armazenado em cache

Sobre solicitações de mapas climáticos

Para solicitar mapas climáticos, 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 oferece suporte a diferentes tipos de mapas climáticos, que correspondem a diferentes modelos climáticos e áreas geográficas subjacentes:

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

O mapa de cobertura abaixo mostra as regiões em que os blocos de mapas climáticos estão disponíveis:

Cobertura de blocos de mapas de clima

Sistema de coordenadas de bloco

A API usa o sistema de coordenadas de bloco Web Mercator padrão. Para uma explicação detalhada das coordenadas de mapa e bloco, consulte Blocos de mapas e Coordenadas de mapa e bloco.

Neste sistema:

  • zoom: o nível de zoom (de 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 blocos de 2z x 2z.
  • x: a coordenada X (coluna) do bloco, variando de 0 (mais a oeste) a 2zoom - 1 (mais a leste).
  • y: a coordenada Y (linha) do bloco, variando de 0 (mais ao norte) a 2zoom - 1 (mais ao sul).

Mostrar mapa climático

Para mostrar esses blocos em um aplicativo da Web usando a API 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 climático

O exemplo a seguir solicita blocos de mapas climáticos 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.