Конечная точка 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 июня, выполните следующие действия:
- Сделайте запрос слоев данных для всех слоев для местоположения (x, y).
- Поскольку июнь — шестой месяц года, извлеките шестой URL-адрес из списка
hourlyShadeUrls
. - Почасовые диапазоны даны в 24-часовом формате. Чтобы получить данные за 4:00 PM (16:00), посмотрите 17-й канал.
- Индекс битов (дней) от 0. Чтобы получить данные за 22-й день июня, прочитайте бит 21.
- Биты предоставляют двоичные данные, указывающие, видело ли это местоположение солнце в указанную дату и время. Если бит равен 1, местоположение видело солнце. Если бит равен 0, местоположение видело тень.
Следующий код суммирует вышеописанные шаги:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))