REST 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 )

Когда обработка этого изображения была завершена.

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. посмотрите 17-й канал (соответствует 16:00).
  3. прочитайте 32-битное значение по адресу (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 )

Качество изображения результата.

Дата

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

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

Связанные типы:

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

integer

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

month

integer

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

day

integer

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

ИзображениеКачество

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

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

Перечисления
IMAGERY_QUALITY_UNSPECIFIED Качество неизвестно.
HIGH Базовые изображения и данные DSM были обработаны при разрешении 0,1 м/пиксель.
MEDIUM Базовые изображения и данные DSM были обработаны при разрешении 0,25 м/пиксель.
LOW Базовые изображения и данные DSM были обработаны при разрешении 0,5 м/пиксель.

Методы

get

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