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

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

Google Earth Engine Solar API থেকে Google Maps Platform Solar API-তে স্থানান্তরিত হতে:

  1. আপনার ক্লাউড প্রজেক্টে গুগল ম্যাপস প্ল্যাটফর্ম সোলার এপিআই (Google Maps Platform Solar API) সক্রিয় করুন।
  2. একটি নতুন কী তৈরি করুন এবং এটিকে জিএমপি সোলার এপিআই (GMP Solar API)-এর জন্য সীমাবদ্ধ করুন।
  3. নিচের ধাপে ধাপে দেওয়া নির্দেশাবলী অনুসরণ করে আপনার কোড আপডেট করুন।

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

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

ধাপে ধাপে

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

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

শুধুমাত্র নির্দিষ্ট কিছু পদের অধিকারীরাই ক্লাউড প্রজেক্ট তৈরি করতে পারেন; আপনি যদি প্রজেক্ট তৈরি করতে না পারেন, তাহলে আপনার প্রতিষ্ঠানের প্রশাসকের সাথে যোগাযোগ করুন।

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

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

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

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

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

আপনার গুগল ক্লাউড প্রজেক্ট সেট আপ করার পরে, সোলার এপিআই ব্যবহার করার জন্য আপনাকে অবশ্যই "এপিআই কী ব্যবহার করুন" অংশে বর্ণিত পদ্ধতি অনুযায়ী আপনার এপিআই কী তৈরি এবং সুরক্ষিত করতে হবে। অথবা, আপনি "ওঅথ ব্যবহার করুন" অংশে বর্ণিত পদ্ধতি অনুযায়ী একটি ওঅথ টোকেন তৈরি করতে পারেন।

সোলার এপিআই ব্যবহার করুন

  • নতুন এন্ডপয়েন্টগুলিতে 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

মূল প্রিভিউ রিলিজের প্রতিক্রিয়া

৯ই মে, ২০২৩-এর মূল প্রিভিউ রিলিজের ক্ষেত্রে, রেসপন্সের 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-গুলো অ্যাক্সেস করার জন্য আপনাকে অবশ্যই একটি API কী পাস করতে হবে । আপনি যদি 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;
  }
}

মনিটর

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

Cloud MonitoringCloud Billing

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

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