ย้ายข้อมูลไปยัง Solar API บน Google Maps Platform

หากต้องการย้ายจาก Google Earth Engine Solar API ไปยัง Google Maps Platform Solar API ให้ทำดังนี้

  1. เปิดใช้ Solar API ของ Google Maps Platform ในโปรเจ็กต์ระบบคลาวด์ของคุณ
  2. สร้างคีย์ใหม่และจำกัดเฉพาะ GMP Solar API
  3. อัปเดตโค้ดโดยใช้คำแนะนำทีละขั้นตอนด้านล่าง

การเปรียบเทียบข้อมูลคู่กัน

Solar API (ใหม่) บ้านที่ปกคลุมด้วยดวงอาทิตย์ Earth Engine Solar API (เลิกใช้งานแล้ว) ไอคอน EE
สถานะการเปิดใช้งาน เปิดตัวแล้ว การนำร่อง (เลิกใช้งานแล้ว)
การเข้าถึง
กลไก บัญชี Google Cloud ผ่าน Cloud Console โดยการเปิดใช้ Solar API และจัดการ API ผ่านส่วน Google Maps Platform บัญชี Google Cloud ผ่าน Cloud Console โดยการเปิดใช้ Earth Engine Solar API
ใคร สาธารณะ มีการควบคุมการเข้าถึง
ระดับ จัดสรรด้วยตนเอง การเข้าถึงด้วยตนเองสำหรับโปรเจ็กต์ระบบคลาวด์
การตรวจสอบสิทธิ์ คีย์ API และ OAuth คีย์ API
ราคา
การพากย์เสียง Pay-as-you-go ส่วนลด 100%
การแบ่งระดับ ต่อคำค้นหา 1, 000 รายการ โดยมีราคาลดลงตามปริมาณ –
ปลายทาง ราคาต่อปลายทางแตกต่างกัน –
Cloud
Monitoring Cloud Monitoring ใต้ "Google Maps Platform" Cloud Monitoring ในส่วน "API และบริการ"
โควต้า QPM (คำค้นหาต่อนาที) และ QPH (คำค้นหาต่อชั่วโมง) รายปี
Logging Cloud Logging (ไม่บังคับ) Cloud Logging (ไม่บังคับ)
การเรียกเก็บเงิน บัญชีสำหรับการเรียกเก็บเงินใน Cloud -
การสนับสนุน การรองรับแพลตฟอร์ม Google Maps เต็มรูปแบบพร้อมด้วย SLO/SLA จำกัดทางอีเมล
API
ชื่อโฮสต์ https://solar.googleapis.com/v1/ (ส่วนที่เหลือ) https://earthenginesolar.googleapis.com/v1/ (ส่วนที่เหลือ)
วิธีการ
  • buildingInsights:findClosest
  • dataLayers:get
  • buildings:findClosest
  • solar.get
คำตอบ ไม่มีการเปลี่ยนแปลงเมื่อเทียบกับการนำร่อง –
solarInfo รัศมี ≤ 100 ม. รัศมี ≤ 100 ม.
ความครอบคลุม
พื้นที่ ประเทศทั่วโลก ประเทศทั่วโลก
คุณภาพของข้อมูล HIGH/MEDIUM HIGH/MEDIUM
ประเภทอาคาร สิ่งปลูกสร้างใดๆ ที่จับคู่กับที่อยู่ และ ภายในความครอบคลุมภาพของ Solar API สิ่งปลูกสร้างใดๆ ที่จับคู่กับที่อยู่ และ ภายในความครอบคลุมภาพของ Solar API
ข้อกำหนดในการให้บริการ
TOS ข้อกำหนดของ Google Maps Platform ข้อกำหนดของ Google Earth Engine

คำแนะนำทีละขั้นตอน

ตั้งค่าโปรเจ็กต์ Google Cloud

ดูวิธีการที่นี่: ตั้งค่าโปรเจ็กต์ Google Cloud

มีเพียงบทบาทบางส่วนเท่านั้นที่สร้างโปรเจ็กต์ Cloud ได้ หากสร้างโปรเจ็กต์ไม่ได้ โปรดติดต่อผู้ดูแลระบบขององค์กร

นอกจากนี้ คุณยังใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้ด้วย หากต้องการเรียนรู้เพิ่มเติม โปรดดูการเริ่มต้นใช้งาน Google Maps Platform

ตั้งค่าบัญชีสำหรับการเรียกเก็บเงิน

ดูวิธีการที่นี่: วิธีจัดการบัญชีการเรียกเก็บเงิน

คุณใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่มีอยู่กับบัญชีสำหรับการเรียกเก็บเงินที่มีอยู่ได้

รับคีย์ API หรือใช้โทเค็น OAuth

หลังจากตั้งค่าโปรเจ็กต์ Google Cloud คุณต้องสร้างและรักษาความปลอดภัยให้กับคีย์ API เพื่อใช้ Solar API ตามที่อธิบายไว้ในใช้คีย์ API หรือจะสร้างโทเค็น OAuth ตามที่อธิบายไว้ในใช้ OAuth ก็ได้

ใช้ Solar API

  • ส่งคำขอ GET ไปยังปลายทางใหม่ : https://solar.googleapis.com
  • โปรดทราบว่ามีการเปลี่ยนชื่อเมธอดของ API บางส่วน ดังนี้
    • buildings:findClosest → buildingInsights:findClosest
    • solarinfo:get → dataLayers:get

การทดลองใช้ด่วน: ใช้คีย์ API ที่บันทึกไว้จากขั้นตอนก่อนหน้าและแทนที่ YOUR_API_KEY ในตัวอย่างการค้นหาด้านล่างก่อนที่จะโหลด URL ในเบราว์เซอร์

https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.2746464&location.longitude=-121.7530949&radius_meters=10&key=YOUR_API_KEY

คำตอบสำหรับเวอร์ชันตัวอย่างรุ่นแรก

สำหรับเวอร์ชันตัวอย่างเดิมในวันที่ 9 พฤษภาคม 2023 URL ในการตอบกลับจะอยู่ในรูปแบบต่อไปนี้

https://earthengine.googleapis.com/v1alpha/projects/sunroof-api/thumbnails/THUMBNAIL_ID:getPixels

ข้อมูลโค้ดต่อไปนี้เป็นตัวอย่างคำตอบ

{
  "imageryDate": {
    "year": 2015,
    "month": 8,
    "day": 8
  },
  "imageryProcessedDate": {
    "year": 2021,
    "month": 2,
    "day": 15
  },
  "dsmUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32:getPixels",
  "rgbUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/91ed3551f2d0abee20af35e07bd0c927-c96c59e80cf1fc1dc86cf59fc8ec86ba:getPixels",
  "maskUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/e4051553dba6870c03d855ae82c30b7e-7cc8ae6ce7c73f219e3c1924e5c17fc6:getPixels",
  "annualFluxUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/9b0f87f49d778a65c9e27ff936e6dbba-b90be2fe80d25abd4c9e8c4dc809f763:getPixels",
  "monthlyFluxUrl": "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/90e7cca77402f14809e349937f0a0be8-94fafeb4ef42d72f1b3c0652a1cb5518:getPixels",
  "hourlyShadeUrls": [
    "https://earthengine.googleapis.com/v1alpha/projects/geo-solar-api/thumbnails/dcd276e4782aef4ff1b230b781736d37-e193b231ce57a03449afc3e21cf6783b:getPixels",
    ...
  ]
  }

หากต้องการส่งคำขอไปยัง URL ในการตอบกลับ ให้รวม URL ทั้งหมดไว้ในคำขอด้วย

ข้อกำหนดทั้งหมดของคำขอและการตอบกลับนี้อยู่ในเอกสารอ้างอิง

เขียนแอปเพื่อรองรับรูปแบบการตอบกลับทั้ง 2 รูปแบบ

ตอนนี้คุณเขียนแอปที่จัดการทั้งตัวอย่างรูปแบบเดิมและการตอบกลับปัจจุบันได้แล้ว

ความแตกต่างที่สำคัญระหว่างการตอบกลับทั้ง 2 รายการนอกเหนือจากตัว URL จริงคือคุณต้องส่งคีย์ API ไปยังคำขอที่เข้าถึง URL จากรูปแบบการตอบกลับใหม่ หากคุณไม่ใส่คีย์ API คำขอจะล้มเหลว

ตัวอย่างเช่น คุณอาจเพิ่มโค้ดต่อไปนี้ลงในแอปเพื่อตรวจสอบ URL และจัดการแต่ละเวอร์ชันอย่างถูกต้อง

JavaScript

/**
* Function to examine a response URL and to append the API key to the
* URL if it is in the new format.
*/
function prepareGetGeoTiffUrl(geoTiffUrl, apiKey) {
  if (geoTiffUrl.match("solar.googleapis.com")) {
    let url = new URL(geoTiffUrl);
    url.searchParams.set('apiKey', apiKey);
    return url.toString();
  }
  return geoTiffUrl;
}

Python

# Functions to examine a response URL and to append the API key to the
# URL if it is in the new format.

def add_api_key_to_url(base_url: str, api_key: str) -> str:
  '''Formats URL that currently lacks an API key to use the one provided.'''
  return base_url + "&key=" +api_key;

def prepare_geo_tiff_url(base_url: str, api_key: str) -> str:
  '''Prepares URL from GetDataLayers depending on API being called.
    If the geoTIFF url from GetDataLayers is for the solar API GetGeoTiff
      endpoint, append the API key. Otherwise return the URL as is.
  '''
  if re.search("solar.googleapis.com", geo_tiff_url):
    return add_api_key_to_url(geo_tiff_url, api_key)
  return geo_tiff_url

Java


/** Adds API key to a URL. */
private String addApiKeyToUrl(String geoTiffUrl, String apiKey) {
  return geoTiffUrl + "&key=" + apiKey;
}

/**
* Function to examine a response URL and to append the API key to the
* URL if it is in the new format.
*/
private String prepareGetGeoTiffUrl(String geoTiffUrl, String apiKey) {
  Pattern pattern = Pattern.compile("solar.googleapis.com");
  Matcher matcher = pattern.matcher(geoTiffUrl);
  if (matcher.find()) {
    return addApiKeyToUrl(geoTiffUrl, apiKey);
  } else {
    return geoTiffUrl;
  }
}

ตรวจสอบ

ระดับโปรเจ็กต์ ระดับบัญชีสำหรับการเรียกเก็บเงิน

Cloud Monitoring การเรียกเก็บเงินใน Cloud

เคล็ดลับน่ารู้

  • โควต้า: ปริมาณการใช้อินเทอร์เน็ตที่ปรับขนาดได้ (แทนที่จะเป็นรายปีซึ่งจะหายไป)
    • โควต้าปัจจุบันซึ่งจะเปลี่ยนเป็น QPM
    • แนวทางปฏิบัติแนะนำ: กำหนดโควต้าฝั่งไคลเอ็นต์และส่งการแจ้งเตือน
  • การกำหนดราคา
    • Pay-as-you-go
    • การตอบกลับ 404 NOT_FOUND เมื่อตำแหน่งไม่ได้อยู่ในช่วงที่ครอบคลุม จะไม่มีการเรียกเก็บเงินแต่จะนับรวมอยู่ในโควต้า
  • ข้อกำหนดการใช้งานทั่วไป: ข้อกำหนดในการให้บริการของ Google Maps Platform