REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object ( Date )

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

object ( Date )

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

string

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

string

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

string

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

string

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

string

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

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 часа; полдень всегда является «стандартным временем»).

enum ( ImageryQuality )

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

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