Membuat permintaan lapisan data

Endpoint dataLayers memberikan informasi tenaga surya yang mendetail untuk wilayah yang mengelilingi lokasi tertentu. Endpoint akan menampilkan 17 file TIFF yang dapat didownload, termasuk:

  • Model permukaan digital (DSM)
  • Lapisan komposit RGB (gambar udara)
  • Lapisan topeng yang mengidentifikasi batas-batas analisis
  • Fluks matahari tahunan, atau hasil tahunan dari permukaan tertentu
  • Fluks matahari bulanan, atau hasil bulanan dari permukaan tertentu
  • Warna per jam (24 jam)

Untuk mengetahui informasi selengkapnya tentang cara Solar API menetapkan fluks, lihat Konsep Solar API.

Tentang permintaan lapisan data

Contoh berikut menunjukkan URL permintaan REST ke metode dataLayers:

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

Sertakan parameter URL permintaan Anda yang menentukan hal berikut:

  • Koordinat lintang dan bujur lokasi
  • Radius wilayah di sekitar lokasi
  • Subset data yang akan ditampilkan (DSM, RGB, mask, fluks tahunan, atau fluks bulanan)
  • Kualitas minimum yang diizinkan dalam hasil
  • Skala minimum data yang akan ditampilkan, dalam meter per piksel

Contoh permintaan lapisan data

Contoh berikut meminta semua informasi insight bangunan dalam radius 100 meter untuk lokasi pada koordinat lintang = 37,4450 dan bujur = -122,1390:

Kunci API

Untuk membuat permintaan ke URL dalam respons, tambahkan kunci API Anda ke URL:

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"

Anda juga dapat membuat permintaan HTTP dengan menempelkan URL di permintaan cURL ke kolom URL browser Anda. Meneruskan kunci API akan memberi Anda kemampuan penggunaan dan analisis yang lebih baik serta kontrol akses yang lebih baik ke data respons.

Token OAuth

Catatan: Format ini hanya untuk lingkungan pengujian. Untuk informasi lebih lanjut, lihat Menggunakan OAuth.

Untuk membuat permintaan ke URL dalam respons, teruskan nama project penagihan dan token OAuth Anda:

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 menampilkan URL dalam format berikut:

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

Contoh respons

Permintaan tersebut menghasilkan respons JSON dalam bentuk:

{
  "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"
}

Mengakses data respons

Mengakses data melalui URL respons memerlukan autentikasi tambahan. Jika menggunakan kunci autentikasi, Anda harus menambahkan kunci API ke URL. Jika menggunakan autentikasi OAuth, Anda harus menambahkan header OAuth.

Kunci API

Untuk membuat permintaan ke URL dalam respons, tambahkan kunci API Anda ke URL:

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

Anda juga dapat membuat permintaan HTTP dengan menempelkan URL di permintaan cURL ke kolom URL browser Anda. Meneruskan kunci API akan memberi Anda kemampuan penggunaan dan analisis yang lebih baik serta kontrol akses yang lebih baik ke data respons.

Token OAuth

Untuk membuat permintaan ke URL dalam respons, teruskan nama project penagihan dan token OAuth Anda:

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"
        

Dengan pengecualian lapisan RGB, semua file TIFF akan ditampilkan sebagai gambar kosong di aplikasi penampil gambar. Untuk melihat file TIFF yang didownload, impor file tersebut ke software aplikasi pemetaan, seperti QGIS.

Spesifikasi lengkap permintaan dan respons ini tercantum dalam dokumentasi referensi.