Google Maps Platform पर Solar API पर माइग्रेट करें

Google Earth Engine Solar API से Google Maps Platform पर जाने के लिए सोलर एपीआई:

  1. अपने क्लाउड प्रोजेक्ट में Google Maps Platform Solar API को चालू करें.
  2. नई कुंजी बनाएं और उसे GMP Solar API से सीमित करें.
  3. इसका इस्तेमाल करके अपना कोड अपडेट करें: सिलसिलेवार निर्देश इस बारे में ज़्यादा जानें.

अगल-बगल में तुलना

सोलर एपीआई (नया) धूप वाले घर Earth Engine Solar API (अब सेवा में नहीं है) EE का आइकॉन
लॉन्च की स्थिति लॉन्च किया गया पायलट (अब सेवा में नहीं है)
ऐक्सेस
मैकेनिज़्म सोलर एपीआई को चालू करके और Google Maps Platform सेक्शन से एपीआई मैनेज करके, Cloud Console के ज़रिए Google Cloud खाता Earth Engine Solar API को चालू करके, Cloud कंसोल के ज़रिए Google Cloud खाता
कौन सार्वजनिक ऐक्सेस-कंट्रोल किया गया
लेवल खुद मैनेज किया गया Cloud प्रोजेक्ट का मैन्युअल ऐक्सेस
पुष्टि करना एपीआई पासकोड और OAuth API (एपीआई) कुंजी
कीमत
रणनीति Pay-as-you-go 100% छूट
टियरिंग हर 1,000 क्वेरी के हिसाब से, संख्या के हिसाब से कीमत कम होती है –
एंडपॉइंट हर एंडपॉइंट पर अलग-अलग कीमतें –
Cloud
निगरानी "Google Maps Platform" के तहत Cloud निगरानी "एपीआई और सेवाएं" में, क्लाउड मॉनिटरिंग की सुविधा
अनुरोध भेजने की तय सीमा (कोटा) क्यूपीएम (क्वेरी प्रति मिनट) और क्यूपीएच (क्वेरी प्रति घंटा) सालाना
लॉग इन हो रहा है क्लाउड का लॉग बनाना (ज़रूरी नहीं) क्लाउड का लॉग बनाना (ज़रूरी नहीं)
बिलिंग क्लाउड बिलिंग खाता -
सहायता एसएलओ/एसएलओ के साथ Google Maps Platform पर पूरी सहायता ईमेल से सीमित
एपीआई
होस्टनेम 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
इमारत का टाइप ऐसी कोई भी इमारत जिसे सोलर एपीआई से ली गई तस्वीरों के कवरेज में मौजूद पते पर मैप किया गया हो ऐसी कोई भी इमारत जिसे सोलर एपीआई से ली गई तस्वीरों के कवरेज में मौजूद पते पर मैप किया गया हो
सेवा की शर्तें
सेवा की शर्तें Google Maps Platform की शर्तें Google Earth Engine की शर्तें

चरण दर चरण

अपना Google Cloud प्रोजेक्ट सेट अप करना

निर्देश यहां: अपना Google Cloud सेट अप करें प्रोजेक्ट.

सिर्फ़ कुछ भूमिकाएं हासिल कर सकती हैं Cloud प्रोजेक्ट बनाना; अगर आप प्रोजेक्ट नहीं बना पा रहे हैं, तो अपने संगठन का एडमिन.

आपके पास किसी मौजूदा Cloud प्रोजेक्ट का इस्तेमाल करने का भी विकल्प है. ज़्यादा जानने के लिए, शुरू करना देखें Google Maps Platform के साथ.

अपना बिलिंग खाता सेट करें

निर्देश यहां: बिलिंग मैनेज करने का तरीका खाता.

किसी मौजूदा बिलिंग खाते के साथ, Cloud प्रोजेक्ट का इस्तेमाल किया जा सकता है.

एपीआई पासकोड पाएं या OAuth टोकन का इस्तेमाल करें

Google Cloud प्रोजेक्ट सेट अप करने के बाद, आपको एपीआई बनाना और उसे सुरक्षित करना होगा Use API में बताए गए तरीके से Solar API को इस्तेमाल करने का तरीका कुंजी. इसके अलावा, आपके पास OAuth टोकन बनाने का भी विकल्प है जैसा कि OAuth का इस्तेमाल करना लेख में बताया गया है.

सोलर एपीआई का इस्तेमाल करना

  • नए एंडपॉइंट पर जीईटी अनुरोध करें : https://solar.googleapis.com
  • ध्यान दें कि एपीआई से जुड़े कुछ तरीकों के नाम बदल गए हैं:
    • buildings:findClosest → buildingInsights:findClosest
    • solarinfo:get → dataLayers:get

क्विक ट्रायल: पिछले चरण में सेव की गई एपीआई पासकोड का इस्तेमाल करें और उसे बदलें यहां उदाहरण के तौर पर दी गई क्वेरी के YOUR_API_KEY में, यूआरएल लोड करने से पहले ब्राउज़र:

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

ओरिजनल झलक वाली रिलीज़ का जवाब

9 मई, 2023 को रिलीज़ हुए ओरिजनल प्रीव्यू के यूआरएल फ़ॉर्म:

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 की जांच करने के लिए आप अपने ऐप्लिकेशन में निम्न कोड जोड़ सकते हैं और हर वर्शन को सही तरीके से हैंडल करें:

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 क्लाउड बिलिंग

उपयोगी सलाह

  • कोटा: पूरे साल के बजाय, बड़े पैमाने पर इस्तेमाल की जा सकने वाली खपत. यह इस साल खत्म हो जाएगी
    • मौजूदा कोटा जिसे क्यूपीएम में बदल दिया जाएगा
    • सबसे सही तरीके: क्लाइंट-साइड कोटा सेट करना और सूचनाएं भेजना
  • कीमत:
    • Pay-as-you-go
    • 404 NOT_FOUND जवाब, जब जगह की जानकारी कवरेज रेंज में मौजूद नहीं होगी, बिल नहीं भेजा जाएगा, लेकिन इसे कोटे में गिना जाएगा
  • इस्तेमाल की सामान्य शर्तें: Google Maps Platform की सेवा की शर्तें