Сделать запрос слоев данных

Конечная точка dataLayers предоставляет подробную информацию о солнечной энергии для региона, окружающего указанное местоположение. Конечная точка возвращает 17 загружаемых файлов TIFF, в том числе:

  • Цифровая модель поверхности (DSM)
  • Комбинированный слой RGB (аэрофотоснимки)
  • Маскирующий слой, определяющий границы анализа.
  • Годовой солнечный поток или годовая урожайность данной поверхности.
  • Ежемесячный солнечный поток или ежемесячная урожайность данной поверхности.
  • Почасовая тень (24 часа)

Дополнительные сведения о том, как Solar API определяет поток, см. в разделе «Концепции Solar API» .

О запросах слоев данных

В следующем примере показан URL-адрес запроса REST к методу dataLayers :

https://solar.googleapis.com/v1/dataLayers:get?parameters

Включите параметры URL-адреса запроса, которые определяют следующее:

  • Координаты широты и долготы местоположения
  • Радиус региона вокруг локации
  • Подмножество возвращаемых данных (DSM, RGB, маска, годовой поток или ежемесячный поток).
  • Минимальное качество, разрешенное в результатах
  • Минимальный масштаб возвращаемых данных, в метрах на пиксель.

Пример запроса слоев данных

В следующем примере запрашивается вся информация о зданиях в радиусе 100 метров для местоположения с координатами широты = 37,4450 и долготы = -122,1390:

API-ключ

Чтобы сделать запрос к URL-адресу в ответе, добавьте к URL-адресу свой ключ API:

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

Вы также можете отправлять HTTP-запросы, вставив URL-адрес из запроса cURL в строку URL-адреса вашего браузера. Передача ключа API предоставляет вам лучшие возможности использования и анализа, а также лучший контроль доступа к данным ответа.

Токен OAuth

Примечание. Этот формат предназначен только для среды тестирования. Дополнительные сведения см. в разделе Использование OAuth .

Чтобы сделать запрос к URL-адресу в ответе, укажите название своего платежного проекта и токен OAuth:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

API возвращает URL-адреса в следующем формате:

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

Пример ответа

Запрос выдает ответ JSON в форме:

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

Доступ к данным ответа

Доступ к данным через URL-адреса ответов требует дополнительной аутентификации. Если вы используете ключ аутентификации, вы должны добавить свой ключ API к URL-адресу. Если вы используете аутентификацию OAuth, вам необходимо добавить заголовки OAuth.

API-ключ

Чтобы сделать запрос к URL-адресу в ответе, добавьте к URL-адресу свой ключ API:

curl -X GET "https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

Вы также можете отправлять HTTP-запросы, вставив URL-адрес из запроса cURL в строку URL-адреса вашего браузера. Передача ключа API предоставляет вам лучшие возможности использования и анализа, а также лучший контроль доступа к данным ответа.

Токен OAuth

Чтобы сделать запрос к URL-адресу в ответе, укажите название своего платежного проекта и токен OAuth:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

За исключением слоя RGB, все файлы TIFF будут отображаться в приложениях для просмотра изображений как пустые изображения. Чтобы просмотреть загруженные файлы TIFF, импортируйте их в картографическое приложение, например QGIS.

Полная спецификация этого запроса и ответа находится в справочной документации .