Тайловые карты

Доступные параметры

Вы можете получить тайловые погодные карты по параметрам:

  • humidity – относительная влажность,
  • prec – количество осадков (в миллиметрах),
  • pressureMm – атмосферное давление на этот час,
  • snowDepth – глубина снега,
  • soilMoisture – влажность почвы,
  • soilTemperature – средняя температура почвы,
  • surfaceTemperature – средняя температура поверхности,
  • temperature – средняя температура,
  • waterTemperature – средняя температура воды,
  • windSpeed – скорость ветра.

Тайловые карты осадков доступны отдельно, см. соответствующий раздел документации.

Таймлайн

Сначала неободимо получить информацию о доступных моментах времени, для которых можно получить тайлы. В поле time используется ISO-файл, который содержит информацию о часовом поясе. Список таких шагов называется "Таймлайн".

Пример запроса:



{
  tiles(request: { lat:  52.37175, lon: 4.89358 }) {
    temperature {
      steps {
        genTime

        time
        timestamp

        bounds {
          lat { min max }
          lon { min max }
        }

        resolution { x y }

        value
      }
    }
  }
}

Ответ на запрос:

{
  "data": {
    "tiles": {
      "temperature": {
        "steps": [
          {
            // Время генерации прогноза (gen_time).
            // Используется для синхронизации тайлов.
            // Обязательный параметр при запросах тайлов.
            "genTime": "1673948778",

            // Время шага.
            "time": "2023-01-15T10:00:00+01:00",

            // Время шага (for_date).
            // Обязательный параметр при запросах тайлов.
            "timestamp": "1673773200",

            // Границы, где данные тайлов доступны.
            "bounds": {
              "lat": {
                "min": -90,
                "max": 90
              },
              "lon": {
                "min": -180,
                "max": 180
              }
            },

            // Разрешение одного пикселя изображения (в градусах).
            "resolution": {
              "x": 0.02,
              "y": 0.02
            },

            // Значение параметра (в данном примере – температура).
            "value": 5
          }
        ]
      }
    }
  }
}

Тайлы

После того, как запрошен таймлайн, можно получить тайлы:

https://api.weather.yandex.ru/frontend/raster-maps/temperature/tile?x={x}&y={y}&z={z}&for_date=1673773200&gen_time=1673948778

Тайлы передаются как тайловые карты, запрос должен содержать следующие параметры:

  • for_date – таймстемп, для какого шага нужен тайл,
  • gen_time – время генерации прогноза (для синхронизации).

Кроме того, поддерживаются следующие параметры:

  • proj – используемая проекция тайлов, поддерживаются EPSG:3395 (значение по-умолчанию) и EPSG:3857.

Палитры тайлов

Палитра задается через N пар (значение, цвет), промежуточные значения рассчитываются с помощью линейной интерполяции и не включают значения следующей строки.

  1. humidity
    Palette { Value: 0 Color: { Red: 171 Green: 108 Blue: 55 } }
    Palette { Value: 30 Color: { Red: 174 Green: 111 Blue: 56 } }
    Palette { Value: 50 Color: { Red: 98 Green: 174 Blue: 69 } }
    Palette { Value: 80 Color: { Red: 56 Green: 158 Blue: 174 } }
    Palette { Value: 100 Color: { Red: 56 Green: 71 Blue: 116 } }
    
  2. prec
    Palette { Value: 0 Color: { Red: 101 Green: 59 Blue: 10 } }
    Palette { Value: 5.0 Color: { Red: 233 Green: 204 Blue: 188 } }
    Palette { Value: 10.0 Color: { Red: 255 Green: 255 Blue: 255 } }
    Palette { Value: 15.0 Color: { Red: 148 Green: 176 Blue: 213 } }
    Palette { Value: 25.5 Color: { Red: 3 Green: 87 Blue: 142 } }
    
  3. pressureMm
    Palette { Value: 525 Color: { Red: 250 Green: 249 Blue: 155 } }
    Palette { Value: 613 Color: { Red: 221 Green: 237 Blue: 117 } }
    Palette { Value: 678 Color: { Red: 108 Green: 205 Blue: 105 } }
    Palette { Value: 703 Color: { Red: 32 Green: 173 Blue: 151 } }
    Palette { Value: 734 Color: { Red: 3 Green: 125 Blue: 171 } }
    Palette { Value: 755 Color: { Red: 46 Green: 44 Blue: 145 } }
    Palette { Value: 780 Color: { Red: 33 Green: 12 Blue: 44 } }
    
  4. snowDepth
    Palette { Value: 0 Color: { Red: 91 Green: 107 Blue: 132 } }
    Palette { Value: 2 Color: { Red: 55 Green: 172 Blue: 255 } }
    Palette { Value: 10 Color: { Red: 127 Green: 224 Blue: 255 } }
    Palette { Value: 50 Color: { Red: 195 Green: 244 Blue: 255 } }
    Palette { Value: 250 Color: { Red: 255 Green: 255 Blue: 255 } }
    Palette { Value: 500 Color: { Red: 255 Green: 255 Blue: 255 } }
    
  5. soilMoisture
    Palette { Value: 0 Color: { Red: 101 Green: 59 Blue: 10 } }
    Palette { Value: 0.3 Color: { Red: 233 Green: 204 Blue: 188 } }
    Palette { Value: 0.55 Color: { Red: 255 Green: 255 Blue: 255 } }
    Palette { Value: 0.8 Color: { Red: 148 Green: 176 Blue: 213 } }
    Palette { Value: 1 Color: { Red: 3 Green: 87 Blue: 142 } }
    
  6. soilTemperature
    Palette { Value: -63 Color: { Red: 150 Green: 137 Blue: 211 } }
    Palette { Value: -30 Color: { Red: 136 Green: 206 Blue: 202 } }
    Palette { Value: 0 Color: { Red: 95 Green: 143 Blue: 192 } }
    Palette { Value: 16 Color: { Red: 111 Green: 144 Blue: 38 } }
    Palette { Value: 32 Color: { Red: 222 Green: 176 Blue: 3 } }
    Palette { Value: 48 Color: { Red: 236 Green: 97 Blue: 29 } }
    Palette { Value: 64 Color: { Red: 138 Green: 43 Blue: 11 } }
    
  7. surfaceTemperature
    Palette { Value: -63.5 Color: { Red: 150 Green: 137 Blue: 211 } }
    Palette { Value: -30 Color: { Red: 136 Green: 206 Blue: 202 } }
    Palette { Value: 0 Color: { Red: 95 Green: 143 Blue: 192 } }
    Palette { Value: 16 Color: { Red: 111 Green: 144 Blue: 38 } }
    Palette { Value: 32 Color: { Red: 222 Green: 176 Blue: 3 } }
    Palette { Value: 48 Color: { Red: 236 Green: 97 Blue: 29 } }
    Palette { Value: 63.5 Color: { Red: 138 Green: 43 Blue: 11 } }
    
  8. temperature
    Palette { Value: -40 Color: { Red: 23 Green: 0 Blue: 66 } }
    Palette { Value: -30 Color: { Red: 67 Green: 0 Blue: 137 } }
    Palette { Value: -23 Color: { Red: 30 Green: 0 Blue: 184 } }
    Palette { Value: -18 Color: { Red: 25 Green: 25 Blue: 255 } }
    Palette { Value: -13 Color: { Red: 0 Green: 102 Blue: 255 } }
    Palette { Value: -7 Color: { Red: 17 Green: 188 Blue: 250 } }
    Palette { Value: -3 Color: { Red: 78 Green: 226 Blue: 237 } }
    Palette { Value: 3 Color: { Red: 0 Green: 196 Blue: 93 } }
    Palette { Value: 9 Color: { Red: 82 Green: 145 Blue: 0 } }
    Palette { Value: 14 Color: { Red: 154 Green: 191 Blue: 0 } }
    Palette { Value: 20 Color: { Red: 237 Green: 230 Blue: 21 } }
    Palette { Value: 25 Color: { Red: 244 Green: 173 Blue: 51 } }
    Palette { Value: 31 Color: { Red: 234 Green: 85 Blue: 40 } }
    Palette { Value: 36 Color: { Red: 193 Green: 39 Blue: 54 } }
    Palette { Value: 40 Color: { Red: 130 Green: 17 Blue: 43 } }
    
  9. waterTemperature
    Palette { Value: -2 Color: { Red: 95 Green: 148 Blue: 196 } }
    Palette { Value: 10 Color: { Red: 109 Green: 144 Blue: 40 } }
    Palette { Value: 20 Color: { Red: 222 Green: 176 Blue: 3 } }
    Palette { Value: 30 Color: { Red: 236 Green: 95 Blue: 21 } }
    Palette { Value: 40 Color: { Red: 138 Green: 43 Blue: 11 } }
    
  10. windSpeed
    Palette { Value: 0 Color: { Red: 115 Green: 53 Blue: 217 } }
    Palette { Value: 3 Color: { Red: 45 Green: 125 Blue: 244 } }
    Palette { Value: 7 Color: { Red: 28 Green: 208 Blue: 96 } }
    Palette { Value: 11 Color: { Red: 238 Green: 186 Blue: 29 } }
    Palette { Value: 17 Color: { Red: 230 Green: 79 Blue: 43 } }
    Palette { Value: 21 Color: { Red: 188 Green: 45 Blue: 72 } }
    Palette { Value: 30 Color: { Red: 56 Green: 0 Blue: 63 } }
    
Предыдущая