REST Resource: dataLayers

Resource: DataLayers

Информация о солнечном потенциале региона. Фактические данные содержатся в нескольких файлах GeoTIFF, охватывающих запрошенный регион, для которого это сообщение содержит URL-адреса: Каждая строка в сообщении DataLayers содержит URL-адрес, по которому можно получить соответствующий файл GeoTIFF. Эти URL-адреса действительны в течение нескольких часов после их создания. Большинство файлов GeoTIFF имеют разрешение 0,1 м/пиксель, но файл ежемесячного потока имеет разрешение 0,5 м/пиксель, а файлы почасового затенения — 1 м/пиксель. Если в запросе GetDataLayersRequest указано значение pixelSizeMeters , то минимальное разрешение в файлах GeoTIFF будет равно этому значению.

JSON-представление 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
Поля
imageryDate

object ( Date )

Когда был сделан исходный снимок (из которого получены все остальные данные) в этом регионе? Он, безусловно, несколько приблизителен, поскольку снимки могли быть сделаны в течение нескольких дней.

imageryProcessedDate

object ( Date )

When processing was completed on this imagery.

dsmUrl

string

URL-адрес изображения цифровой модели поверхности (DSM) региона. Значения указаны в метрах над геоидом EGM96 (т.е. уровнем моря). Недействительные местоположения (по которым нет данных) сохраняются как -9999.

rgbUrl

string

URL-адрес изображения RGB-данных (аэрофотоснимок) региона.

maskUrl

string

URL-адрес изображения маски здания: один бит на пиксель, указывающий, считается ли этот пиксель частью крыши или нет.

annualFluxUrl

string

URL-адрес карты годового потока (ежегодного количества солнечного света на крышах) региона. Значения указаны в кВт⋅ч/кВт/год. Это немаскированный поток : поток рассчитывается для каждой локации, а не только для крыш зданий. Недействительные локации сохраняются как -9999: локации за пределами нашей зоны покрытия будут недействительными, а несколько локаций внутри зоны покрытия, для которых нам не удалось рассчитать поток, также будут недействительными.

monthlyFluxUrl

string

URL-адрес ежемесячной карты потока (солнечного света на крышах с разбивкой по месяцам) для региона. Значения указаны в кВт·ч/кВт/год. GeoTIFF-файл, на который указывает этот URL-адрес, будет содержать двенадцать диапазонов, соответствующих периоду с января по декабрь (по порядку).

hourlyShadeUrls[]

string

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

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

  1. выберите шестой URL-адрес в этом списке (соответствует июню).
  2. look up the 17th channel (corresponding to 4pm).
  3. read the 32-bit value at (x, y).
  4. прочитать 21-й бит значения (соответствует 22-му числу месяца).
  5. если этот бит равен 1, то это место видело солнце в 16:00 22 июня.

Более формально: учитывая month (1-12), day (1...месяц максимум; в феврале 28 дней) и hour (0-23), тень/солнце для этого месяца/дня/часа в позиции (x, y) является битом

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

Где (x, y) — пространственное индексирование, [month - 1] — выбор URL-адреса month - 1 (индексация с нуля), [hour] — индексация по каналам, а конечный результат, отличный от нуля, означает «солнечно». Високосных дней нет, и летнего времени не существует (все дни длятся 24 часа; полдень всегда соответствует полудню по «стандартному времени»).

imageryQuality

enum ( ImageryQuality )

The quality of the result's imagery.

Дата

Представляет собой полную или частичную календарную дату, например, день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указана относительно григорианского календаря. Может представлять собой одно из следующих событий:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год сам по себе, с нулевым месяцем и нулевым днем.
  • Год и месяц с нулевым днем ​​(например, дата истечения срока действия кредитной карты).

Related types:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год даты. Должен быть от 1 до 9999 или 0, чтобы указать дату без года.

month

integer

Месяц года. Должен быть от 1 до 12 или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должен быть от 1 до 31 и действителен для года и месяца, или 0, чтобы указать только год или год и месяц, если день не имеет значения.

ImageryQuality

Качество изображений, используемых для вычисления некоторых результатов API.

Примечание: Независимо от уровня качества изображений выходные данные DSM всегда имеют разрешение 0,1 м/пиксель, выходные данные ежемесячного потока всегда имеют разрешение 0,5 м/пиксель, а выходные данные почасового затенения всегда имеют разрешение 1 м/пиксель.

Перечисления
IMAGERY_QUALITY_UNSPECIFIED No quality is known.
HIGH Данные о солнечной активности получены с помощью аэрофотоснимков, сделанных на малой высоте и обработанных с разрешением 0,1 м/пиксель.
MEDIUM Данные о солнечной активности получены с помощью улучшенных аэрофотоснимков, сделанных на большой высоте и обработанных с разрешением 0,25 м/пиксель.
BASE Данные о солнечной активности получены с помощью улучшенных спутниковых снимков, обработанных с разрешением 0,25 м/пиксель.

Методы

get

 Получает информацию о солнечной активности в регионе, окружающем определенное местоположение.