О файлах GeoTIFF

Рендеринг 4-х сложенных растров.

Конечная точка dataLayers возвращает данные, закодированные в виде файлов GeoTIFF, которые можно использовать в любом приложении географической информационной системы (ГИС) для проектирования солнечных систем.

Каждая строка в ответе dataLayers содержит URL, который можно использовать для получения соответствующего GeoTIFF. URL действительны в течение часа после того, как они были сгенерированы из исходного запроса слоев данных. Файлы GeoTIFF могут храниться до 30 дней.

За исключением слоя RGB, файлы GeoTIFF не отображаются корректно в просмотрщике изображений, поскольку содержимое представляет собой закодированные данные, а не изображения RGB. Файлы GeoTIFF также не могут использоваться напрямую в качестве накладываемого изображения с API Javascript Карт.

В следующей таблице подробно описан каждый слой.

Слой Глубина пикселя Разрешение Описание
Цифровая модель поверхности (DSM) 32-битное число с плавающей точкой 0,1 м/пиксель Данные о высоте, которые отображают топографию поверхности Земли, включая естественные и построенные объекты. Значения указаны в метрах над уровнем моря. Недействительные местоположения или области, по которым у нас нет данных, сохраняются как -9999.
РГБ 8-битный 0,1 м/пиксель
0,25 м/пиксель
0,5 м/пиксель
1 м/пиксель
Аэрофотоснимок региона. Файл изображения GeoTIFF содержит три полосы, соответствующие значениям красного, зеленого и синего цветов, чтобы сформировать 24-битное значение RGB для каждого пикселя.

По умолчанию разрешение пикселей составляет 0,1 м/пиксель.
Строительная маска 1-битный 0,1 м/пиксель Один бит на пиксель указывает, считается ли этот пиксель частью крыши.
Годовой поток 32-битное число с плавающей точкой 0,1 м/пиксель Годовая карта потока или годового солнечного света на крышах региона. Значения кВтч/кВт/год.

Flux вычисляется для каждого местоположения, а не только для крыш зданий. Недействительные местоположения или области, где мы не смогли рассчитать flux, сохраняются как -9999. Места за пределами нашей зоны покрытия являются недействительными.

Примечание: это немаскированный флюс.
Ежемесячный поток 32-битное число с плавающей точкой 0,5 м/пиксель Карта ежемесячного потока (солнечный свет на крышах, разбитый по месяцам) региона. Значения — кВт·ч/кВт/год. Файл изображения GeoTIFF содержит 12 полос, соответствующих январю — декабрю, по порядку.
Почасовая тень 32-битное целое число 1 м/пиксель 12 URL-адресов для почасовых карт теней, соответствующих периоду с января по декабрь, по порядку.

Каждый файл GeoTIFF содержит 24 полосы, соответствующие 24 часам дня. Каждый пиксель — это 32-битное целое число, соответствующее (до) 31 дням этого месяца. 1 бит означает, что соответствующее местоположение может видеть солнце в этот день, в этот час, в этом месяце.

Недействительные местоположения сохраняются как -9999 и имеют установленный бит 31, поскольку он соответствует 32-му дню месяца и, следовательно, является недействительным.

Декодирование почасовых растров теней

Почасовые данные о затенении кодируются в многополосных растрах. Чтобы узнать больше об основах растра, см. Solar API Concepts .

При запросе почасовых данных о тенях вы можете получить до 12 растров, по одному на каждый месяц календарного года (с января по декабрь). Каждый растр состоит из 24 слоев, или полос , которые соответствуют 24 часам дня.

Каждая полоса представлена ​​матрицей ячеек или пикселей . Каждый пиксель имеет глубину 32 бита, что соответствует (максимум) 31 дню месяца. Поэтому декодирование дня, времени и месяца данных оттенков требует понимания бита, полосы и растра, которые вы анализируете.

Например, чтобы определить, было ли солнце в заданном месте с координатами (x, y) в 16:00 22 июня, выполните следующие действия:

  1. Сделайте запрос слоев данных для всех слоев для местоположения (x, y).
  2. Поскольку июнь — шестой месяц года, извлеките шестой URL-адрес из списка hourlyShadeUrls .
  3. Почасовые диапазоны даны в 24-часовом формате. Чтобы получить данные за 4:00 PM (16:00), посмотрите 17-й канал.
  4. Индекс битов (дней) от 0. Чтобы получить данные за 22-й день июня, прочитайте бит 21.
  5. Биты предоставляют двоичные данные, указывающие, видело ли это местоположение солнце в указанную дату и время. Если бит равен 1, местоположение видело солнце. Если бит равен 0, местоположение видело тень.

Следующий код суммирует вышеописанные шаги:

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))