Google Maps প্ল্যাটফর্মে Solar API-এ স্থানান্তর করুন

গুগল আর্থ ইঞ্জিন সোলার এপিআই থেকে গুগল ম্যাপ প্ল্যাটফর্ম সোলার এপিআইতে যেতে:

1. আপনার ক্লাউড প্রকল্পে Google মানচিত্র প্ল্যাটফর্ম সোলার API সক্ষম করুন৷
2. একটি নতুন কী তৈরি করুন এবং এটিকে GMP Solar API এ সীমাবদ্ধ করুন।
3. নীচের ধাপে ধাপে নির্দেশাবলী ব্যবহার করে আপনার কোড আপডেট করুন।

পাশাপাশি তুলনা

	Solar API (নতুন)	আর্থ ইঞ্জিন সোলার এপিআই (অপ্রচলিত)
লঞ্চ স্থিতি	চালু হয়েছে	পাইলট (বঞ্চিত)
অ্যাক্সেস
মেকানিজম	ক্লাউড কনসোলের মাধ্যমে Google ক্লাউড অ্যাকাউন্ট, Solar API সক্ষম করে এবং Google Maps প্ল্যাটফর্ম বিভাগের মাধ্যমে API পরিচালনা করে	আর্থ ইঞ্জিন সোলার এপিআই সক্ষম করে ক্লাউড কনসোলের মাধ্যমে Google ক্লাউড অ্যাকাউন্ট
WHO	পাবলিক	অ্যাক্সেস-নিয়ন্ত্রিত
স্তর	স্ব-বিধান	ক্লাউড প্রকল্প ম্যানুয়াল অ্যাক্সেস
প্রমাণীকরণ	API কী এবং OAuth	API কী
মূল্য নির্ধারণ
কৌশল	আপনি-যেমন-প্রদান করুন	100% ডিসকাউন্ট
টিয়ারিং	ভলিউমের উপর ভিত্তি করে মূল্য হ্রাস সহ প্রতি 1000টি প্রশ্ন	-
শেষবিন্দু	ভিন্ন, প্রতি-এন্ডপয়েন্ট দাম	-
মেঘ
মনিটরিং	"গুগল ম্যাপ প্ল্যাটফর্ম" এর অধীনে ক্লাউড মনিটরিং	"APIs এবং পরিষেবাগুলি" এর অধীনে ক্লাউড মনিটরিং
কোটা	QPM (প্রতি মিনিটে প্রশ্ন) এবং QPH (প্রতি ঘণ্টায় প্রশ্ন)	বার্ষিক
লগিং	ক্লাউড লগিং (ঐচ্ছিক)	ক্লাউড লগিং (ঐচ্ছিক)
বিলিং	ক্লাউড বিলিং অ্যাকাউন্ট	-
সমর্থন	SLO/SLA এর সাথে সম্পূর্ণ Google Maps প্ল্যাটফর্ম সমর্থন	সীমিত, ইমেল দ্বারা
API
হোস্টনাম	https://solar.googleapis.com/v1/ (REST)	https://earthenginesolar.googleapis.com/v1/ (REST)
পদ্ধতি	buildingInsights:findClosest dataLayers:get	buildings:findClosest solar.get
প্রতিক্রিয়া	পাইলটের তুলনায় কোন পরিবর্তন নেই	-
solarInfo	≤100m ব্যাসার্ধ	≤100m ব্যাসার্ধ
কভারেজ
এলাকা	গ্লোবাল	গ্লোবাল
ডেটা গুণমান	HIGH / MEDIUM	HIGH / MEDIUM
বিল্ডিং টাইপ	যে কোনও বিল্ডিং যা একটি ঠিকানায় ম্যাপ করা হয়েছে এবং সোলার এপিআই চিত্র কভারেজের মধ্যে রয়েছে৷	যে কোনও বিল্ডিং যা একটি ঠিকানায় ম্যাপ করা হয়েছে এবং সোলার এপিআই চিত্র কভারেজের মধ্যে রয়েছে৷
পরিষেবার শর্তাবলী
TOS	Google Maps প্ল্যাটফর্মের শর্তাবলী	গুগল আর্থ ইঞ্জিন শর্তাবলী

ধাপে ধাপে

আপনার Google ক্লাউড প্রকল্প সেট আপ করুন

এখানে নির্দেশাবলী: আপনার Google ক্লাউড প্রকল্প সেট আপ করুন ।

শুধুমাত্র নির্দিষ্ট ভূমিকা একটি ক্লাউড প্রকল্প তৈরি করতে পারে; আপনি একটি প্রকল্প তৈরি করতে না পারলে, আপনার প্রতিষ্ঠানের প্রশাসকের সাথে যোগাযোগ করুন।

আপনি একটি বিদ্যমান ক্লাউড প্রকল্পও ব্যবহার করতে পারেন। আরও জানতে, Google মানচিত্র প্ল্যাটফর্মের সাথে শুরু করা দেখুন।

আপনার বিলিং অ্যাকাউন্ট সেট আপ করুন

এখানে নির্দেশাবলী: আপনার বিলিং অ্যাকাউন্ট কিভাবে পরিচালনা করবেন ।

আপনি একটি বিদ্যমান বিলিং অ্যাকাউন্টের সাথে একটি বিদ্যমান ক্লাউড প্রকল্প ব্যবহার করতে পারেন।

একটি API কী পান বা OAuth টোকেন ব্যবহার করুন৷

আপনার Google ক্লাউড প্রজেক্ট সেট আপ করার পর, ইউজ API কী -তে বর্ণিত সোলার API ব্যবহার করার জন্য আপনাকে অবশ্যই আপনার API কী তৈরি এবং সুরক্ষিত করতে হবে। অথবা, আপনি OAuth ব্যবহার করুন -এ বর্ণিত একটি OAuth টোকেন তৈরি করতে পারেন।

Solar API ব্যবহার করুন

• নতুন এন্ডপয়েন্টে GET অনুরোধ করুন: https://solar.googleapis.com
• মনে রাখবেন কিছু API পদ্ধতির নাম পরিবর্তিত হয়েছে:
  • buildings:findClosest → buildingInsights:findClosest
  • solarinfo:get → dataLayers:get

দ্রুত ট্রায়াল : আপনার ব্রাউজারে URL লোড করার আগে, পূর্ববর্তী ধাপ থেকে সংরক্ষিত API কী ব্যবহার করুন এবং নীচের উদাহরণের প্রশ্নে 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-এ আসল প্রিভিউ রিলিজের জন্য, প্রতিক্রিয়াতে 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 অন্তর্ভুক্ত করুন৷

এই অনুরোধ এবং প্রতিক্রিয়ার সম্পূর্ণ স্পেসিফিকেশন রেফারেন্স ডকুমেন্টেশনে রয়েছে।

উভয় প্রতিক্রিয়া বিন্যাস সমর্থন করার জন্য একটি অ্যাপ লিখুন

আপনি এখন একটি অ্যাপ লিখতে পারেন যা মূল পূর্বরূপ এবং বর্তমান প্রতিক্রিয়া বিন্যাস উভয়ই পরিচালনা করে।

দুটি প্রতিক্রিয়ার মধ্যে প্রধান পার্থক্য, প্রকৃত URL ব্যতীত, আপনাকে একটি অনুরোধের জন্য একটি API কী পাস করতে হবে যা নতুন প্রতিক্রিয়া বিন্যাস থেকে URLগুলি অ্যাক্সেস করে৷ আপনি API কী বাদ দিলে, অনুরোধ ব্যর্থ হয়।

উদাহরণস্বরূপ, আপনি URL পরীক্ষা করতে এবং প্রতিটি সংস্করণ সঠিকভাবে পরিচালনা করতে আপনার অ্যাপে নিম্নলিখিত কোড যোগ করতে পারেন:

/**
* 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;
}

# 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

/** 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;
  }
}

মনিটর

প্রকল্প স্তর	বিলিং অ্যাকাউন্ট স্তর

জেনে রাখা ভালো টিপস

• কোটা: খরচ যা স্কেল করতে পারে (বার্ষিকের পরিবর্তে যা অদৃশ্য হয়ে যাবে)
  • বর্তমান কোটা QPM-এ পরিবর্তিত হবে
  • সর্বোত্তম অনুশীলন: ক্লায়েন্ট-সাইড কোটা সেট করুন এবং সতর্কতা পাঠান
• মূল্য নির্ধারণ:
  • আপনি-যেমন-প্রদান করুন
  • 404 NOT_FOUND প্রতিক্রিয়া, যখন অবস্থান কভারেজ পরিসরে না হয়, তখন বিল করা হবে না কিন্তু কোটার সাথে গণনা করা হবে
• সাধারণ ব্যবহারের শর্তাবলী: Google Maps Platform পরিষেবার শর্তাবলী৷