REST Resource: dataLayers

সম্পদ: ডেটা লেয়ার

একটি অঞ্চলের সৌর সম্ভাবনা সম্পর্কে তথ্য। প্রকৃত ডেটা অনুরোধ করা অঞ্চলকে কভার করে এমন কয়েকটি জিওটিআইএফএফ ফাইলের মধ্যে রয়েছে, যার জন্য এই বার্তাটিতে URL রয়েছে: DataLayers বার্তার প্রতিটি স্ট্রিংয়ে একটি URL রয়েছে যেখান থেকে সংশ্লিষ্ট জিওটিআইএফএফ আনা যেতে পারে। এই URLগুলি তৈরি হওয়ার কয়েক ঘন্টার জন্য বৈধ। বেশিরভাগ জিওটিআইএফএফ ফাইলের রেজোলিউশন 0.1 মিটার/পিক্সেল, তবে মাসিক ফ্লাক্স ফাইল 0.5 মিটার/পিক্সেল, এবং প্রতি ঘণ্টার শেড ফাইলগুলি 1 মিটার/পিক্সেল। যদি একটি pixelSizeMeters মান GetDataLayersRequest এ নির্দিষ্ট করা থাকে, তাহলে জিওটিআইএফএফ ফাইলগুলিতে ন্যূনতম রেজোলিউশনটি সেই মান হবে৷

JSON প্রতিনিধিত্ব
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
ক্ষেত্র
imageryDate

object ( Date )

যখন এই অঞ্চলের উত্স চিত্র (যা থেকে অন্যান্য সমস্ত ডেটা নেওয়া হয়) নেওয়া হয়েছিল। এটি অগত্যা কিছুটা আনুমানিক, কারণ ছবিগুলি এক দিনেরও বেশি সময় ধরে নেওয়া হতে পারে৷

imageryProcessedDate

object ( Date )

যখন এই চিত্রের উপর প্রক্রিয়াকরণ সম্পন্ন হয়েছিল।

dsmUrl

string

এই অঞ্চলের DSM (ডিজিটাল সারফেস মডেল) ছবির জন্য URL। মানগুলি EGM96 geoid (যেমন, সমুদ্রপৃষ্ঠের) উপরে মিটারে রয়েছে৷ অবৈধ অবস্থানগুলি (যেখানে আমাদের ডেটা নেই) -9999 হিসাবে সংরক্ষণ করা হয়৷

rgbUrl

string

এই অঞ্চলের RGB ডেটার (বায়বীয় ছবি) ছবির URL।

maskUrl

string

বিল্ডিং মাস্ক ইমেজের URL: পিক্সেল প্রতি এক বিট বলছে যে সেই পিক্সেলটিকে ছাদের অংশ হিসাবে বিবেচনা করা হয় কি না।

annualFluxUrl

string

অঞ্চলের বার্ষিক ফ্লাক্স মানচিত্রের (ছাদে বার্ষিক সূর্যালোক) URL। মান হল kWh/kW/বছর। এটি হল মুখোশহীন ফ্লাক্স : ফ্লাক্স প্রতিটি অবস্থানের জন্য গণনা করা হয়, শুধুমাত্র ছাদ নির্মাণের জন্য নয়। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয়েছে: আমাদের কভারেজ এলাকার বাইরের অবস্থানগুলি অবৈধ হবে, এবং কভারেজ এলাকার ভিতরে কয়েকটি অবস্থান, যেখানে আমরা ফ্লাক্স গণনা করতে পারিনি, সেটিও অবৈধ হবে৷

monthlyFluxUrl

string

অঞ্চলের মাসিক ফ্লাক্স মানচিত্রের URL (ছাদে সূর্যালোক, মাস অনুসারে ভাঙ্গা)। মান হল kWh/kW/বছর। এই URL দ্বারা নির্দেশিত জিওটিআইএফএফ-এ বারোটি ব্যান্ড থাকবে, যা জানুয়ারি...ডিসেম্বর, ক্রমানুসারে।

hourlyShadeUrls[]

string

ক্রমানুসারে জানুয়ারী...ডিসেম্বরের সাথে সম্পর্কিত প্রতি ঘন্টার ছায়ার জন্য বারোটি URL। প্রতিটি জিওটিআইএফএফে 24টি ব্যান্ড থাকবে, যা দিনের 24 ঘন্টার সাথে সম্পর্কিত। প্রতিটি পিক্সেল একটি 32 বিট পূর্ণসংখ্যা, সেই মাসের 31 দিনের (পর্যন্ত) সাথে সম্পর্কিত; একটি 1 বিট মানে যে সংশ্লিষ্ট অবস্থানটি সেই দিন, সেই ঘন্টা, সেই মাসের সূর্য দেখতে সক্ষম। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয় (যেহেতু এটি নেতিবাচক, এটিতে বিট 31 সেট রয়েছে এবং কোনও বৈধ মান বিট 31 সেট থাকতে পারে না কারণ এটি মাসের 32 তম দিনের সাথে সম্পর্কিত হবে)।

একটি উদাহরণ দরকারী হতে পারে. আপনি যদি জানতে চান যে 22শে জুন বিকাল 4 টায় কোন বিন্দু (পিক্সেল অবস্থানে (x, y)) সূর্য দেখেছেন কি না আপনি:

  1. এই তালিকার ষষ্ঠ URL আনুন (জুন এর সাথে সম্পর্কিত)।
  2. 17 তম চ্যানেল দেখুন (বিকাল 4 টার সাথে সম্পর্কিত)।
  3. (x, y) এ 32-বিট মান পড়ুন।
  4. মানের বিট 21 পড়ুন (মাসের 22 তারিখের সাথে সম্পর্কিত)।
  5. যদি সেই বিটটি 1 হয়, তাহলে সেই স্থানটি 22 জুন বিকেল 4 টায় সূর্য দেখেছিল।

আরও আনুষ্ঠানিকভাবে: প্রদত্ত month (1-12), day (1...মাস সর্বাধিক; ফেব্রুয়ারিতে 28 দিন আছে) এবং hour (0-23), একটি অবস্থানে সেই মাসের/দিন/ঘন্টার জন্য ছায়া/সূর্য (x, y) বিট

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

যেখানে (x, y) হল স্থানিক সূচীকরণ, [month - 1] মানে হল month - 1 ম ইউআরএল (শূন্য থেকে সূচীকরণ), [hour] চ্যানেলগুলিতে সূচীকরণ করা হয়, এবং একটি চূড়ান্ত অ-শূন্য ফলাফল মানে "রৌদ্রোজ্জ্বল" . কোন লিপ ডে নেই, এবং ডিএসটি বিদ্যমান নেই (সমস্ত দিন 24 ঘন্টা দীর্ঘ; দুপুর সর্বদা "মানক সময়" দুপুর)।

imageryQuality

enum ( ImageryQuality )

ফলাফলের চিত্রের গুণমান।

তারিখ

একটি সম্পূর্ণ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন একটি জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা হয়েছে বা নগণ্য। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:

  • একটি সম্পূর্ণ তারিখ, অ-শূন্য বছর, মাস এবং দিনের মান সহ।
  • একটি মাস এবং দিন, একটি শূন্য বছর সহ (উদাহরণস্বরূপ, একটি বার্ষিকী)।
  • একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি বছর নিজেই।
  • একটি বছর এবং মাস, একটি শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।

সম্পর্কিত প্রকার:

JSON প্রতিনিধিত্ব
{
  "year": integer,
  "month": integer,
  "day": integer
}
ক্ষেত্র
year

integer

তারিখের বছর। একটি বছর ছাড়া একটি তারিখ নির্দিষ্ট করতে 1 থেকে 9999, বা 0 হতে হবে।

month

integer

এক বছরের মাস। একটি মাস এবং দিন ছাড়া একটি বছর নির্দিষ্ট করতে 1 থেকে 12, বা 0 হতে হবে৷

day

integer

এক মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 নিজে থেকে একটি বছর বা একটি বছর এবং মাস উল্লেখ করতে হবে যেখানে দিনটি তাৎপর্যপূর্ণ নয়৷

চিত্রের গুণমান

কিছু API ফলাফল গণনা করতে ব্যবহৃত চিত্রের গুণমান।

দ্রষ্টব্য: চিত্রের মানের স্তর নির্বিশেষে, DSM আউটপুটগুলির সর্বদা 0.1 মিটার/পিক্সেলের রেজোলিউশন থাকে, মাসিক ফ্লাক্স আউটপুটগুলির সর্বদা 0.5 মিটার/পিক্সেলের একটি রেজোলিউশন থাকে এবং প্রতি ঘন্টার শেড আউটপুটগুলির সর্বদা 1 মিটার/পিক্সেলের রেজোলিউশন থাকে৷

এনামস
IMAGERY_QUALITY_UNSPECIFIED কোন গুণ জানা নেই.
HIGH অন্তর্নিহিত চিত্রাবলী এবং DSM ডেটা 0.1 m/pixel এ প্রক্রিয়া করা হয়েছিল।
MEDIUM অন্তর্নিহিত চিত্র এবং DSM ডেটা 0.25 মি/পিক্সেল এ প্রক্রিয়া করা হয়েছিল।
LOW অন্তর্নিহিত চিত্র এবং DSM ডেটা 0.5 মিটার/পিক্সেল এ প্রক্রিয়া করা হয়েছিল।

পদ্ধতি

get

একটি অবস্থানের আশেপাশের একটি অঞ্চলের জন্য সৌর তথ্য পায়।
,

সম্পদ: ডেটা লেয়ার

একটি অঞ্চলের সৌর সম্ভাবনা সম্পর্কে তথ্য। প্রকৃত ডেটা অনুরোধ করা অঞ্চলকে কভার করে এমন কয়েকটি জিওটিআইএফএফ ফাইলের মধ্যে রয়েছে, যার জন্য এই বার্তাটিতে URL রয়েছে: DataLayers বার্তার প্রতিটি স্ট্রিংয়ে একটি URL রয়েছে যেখান থেকে সংশ্লিষ্ট জিওটিআইএফএফ আনা যেতে পারে। এই URLগুলি তৈরি হওয়ার কয়েক ঘন্টার জন্য বৈধ। বেশিরভাগ জিওটিআইএফএফ ফাইলের রেজোলিউশন 0.1 মিটার/পিক্সেল, তবে মাসিক ফ্লাক্স ফাইল 0.5 মিটার/পিক্সেল, এবং প্রতি ঘণ্টার শেড ফাইলগুলি 1 মিটার/পিক্সেল। যদি একটি pixelSizeMeters মান GetDataLayersRequest এ নির্দিষ্ট করা থাকে, তাহলে জিওটিআইএফএফ ফাইলগুলিতে ন্যূনতম রেজোলিউশনটি সেই মান হবে৷

JSON প্রতিনিধিত্ব
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
ক্ষেত্র
imageryDate

object ( Date )

যখন এই অঞ্চলের উত্স চিত্র (যা থেকে অন্যান্য সমস্ত ডেটা নেওয়া হয়) নেওয়া হয়েছিল। এটি অগত্যা কিছুটা আনুমানিক, কারণ ছবিগুলি এক দিনেরও বেশি সময় ধরে নেওয়া হতে পারে৷

imageryProcessedDate

object ( Date )

যখন এই চিত্রের উপর প্রক্রিয়াকরণ সম্পন্ন হয়েছিল।

dsmUrl

string

এই অঞ্চলের DSM (ডিজিটাল সারফেস মডেল) ছবির জন্য URL। মানগুলি EGM96 geoid (যেমন, সমুদ্রপৃষ্ঠের) উপরে মিটারে রয়েছে৷ অবৈধ অবস্থানগুলি (যেখানে আমাদের ডেটা নেই) -9999 হিসাবে সংরক্ষণ করা হয়৷

rgbUrl

string

এই অঞ্চলের RGB ডেটার (বায়বীয় ছবি) ছবির URL।

maskUrl

string

বিল্ডিং মাস্ক ইমেজের URL: পিক্সেল প্রতি এক বিট বলছে যে সেই পিক্সেলটিকে ছাদের অংশ হিসাবে বিবেচনা করা হয় কি না।

annualFluxUrl

string

অঞ্চলের বার্ষিক ফ্লাক্স মানচিত্রের (ছাদে বার্ষিক সূর্যালোক) URL। মান হল kWh/kW/বছর। এটি হল মুখোশহীন ফ্লাক্স : ফ্লাক্স প্রতিটি অবস্থানের জন্য গণনা করা হয়, শুধুমাত্র ছাদ নির্মাণের জন্য নয়। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয়েছে: আমাদের কভারেজ এলাকার বাইরের অবস্থানগুলি অবৈধ হবে, এবং কভারেজ এলাকার ভিতরে কয়েকটি অবস্থান, যেখানে আমরা ফ্লাক্স গণনা করতে পারিনি, সেটিও অবৈধ হবে৷

monthlyFluxUrl

string

অঞ্চলের মাসিক ফ্লাক্স মানচিত্রের URL (ছাদে সূর্যালোক, মাস অনুসারে ভাঙ্গা)। মান হল kWh/kW/বছর। এই URL দ্বারা নির্দেশিত জিওটিআইএফএফ-এ বারোটি ব্যান্ড থাকবে, যা জানুয়ারি...ডিসেম্বর, ক্রমানুসারে।

hourlyShadeUrls[]

string

ক্রমানুসারে জানুয়ারী...ডিসেম্বরের সাথে সম্পর্কিত প্রতি ঘন্টার ছায়ার জন্য বারোটি URL। প্রতিটি জিওটিআইএফএফে 24টি ব্যান্ড থাকবে, যা দিনের 24 ঘন্টার সাথে সম্পর্কিত। প্রতিটি পিক্সেল একটি 32 বিট পূর্ণসংখ্যা, সেই মাসের 31 দিনের (পর্যন্ত) সাথে সম্পর্কিত; একটি 1 বিট মানে যে সংশ্লিষ্ট অবস্থানটি সেই দিন, সেই ঘন্টা, সেই মাসের সূর্য দেখতে সক্ষম। অবৈধ অবস্থানগুলি -9999 হিসাবে সংরক্ষণ করা হয় (যেহেতু এটি নেতিবাচক, এটিতে বিট 31 সেট রয়েছে এবং কোনও বৈধ মান বিট 31 সেট থাকতে পারে না কারণ এটি মাসের 32 তম দিনের সাথে সম্পর্কিত হবে)।

একটি উদাহরণ দরকারী হতে পারে. আপনি যদি জানতে চান যে 22শে জুন বিকাল 4 টায় কোন বিন্দু (পিক্সেল অবস্থানে (x, y)) সূর্য দেখেছেন কি না আপনি:

  1. এই তালিকার ষষ্ঠ URL আনুন (জুন এর সাথে সম্পর্কিত)।
  2. 17 তম চ্যানেল দেখুন (বিকাল 4 টার সাথে সম্পর্কিত)।
  3. (x, y) এ 32-বিট মান পড়ুন।
  4. মানের বিট 21 পড়ুন (মাসের 22 তারিখের সাথে সম্পর্কিত)।
  5. যদি সেই বিটটি 1 হয়, তাহলে সেই স্থানটি 22 জুন বিকেল 4 টায় সূর্য দেখেছিল।

আরও আনুষ্ঠানিকভাবে: প্রদত্ত month (1-12), day (1...মাস সর্বাধিক; ফেব্রুয়ারিতে 28 দিন আছে) এবং hour (0-23), একটি অবস্থানে সেই মাসের/দিন/ঘন্টার জন্য ছায়া/সূর্য (x, y) হল বিট

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

যেখানে (x, y) হল স্থানিক সূচীকরণ, [month - 1] মানে হল month - 1 ম ইউআরএল (শূন্য থেকে সূচীকরণ), [hour] চ্যানেলগুলিতে সূচীকরণ করা হয়, এবং একটি চূড়ান্ত অ-শূন্য ফলাফল মানে "রৌদ্রোজ্জ্বল" . কোন লিপ ডে নেই, এবং ডিএসটি বিদ্যমান নেই (সমস্ত দিন 24 ঘন্টা দীর্ঘ; দুপুর সর্বদা "মানক সময়" দুপুর)।

imageryQuality

enum ( ImageryQuality )

ফলাফলের চিত্রের গুণমান।

তারিখ

একটি সম্পূর্ণ বা আংশিক ক্যালেন্ডার তারিখ প্রতিনিধিত্ব করে, যেমন একটি জন্মদিন। দিনের সময় এবং সময় অঞ্চল হয় অন্য কোথাও নির্দিষ্ট করা হয়েছে বা নগণ্য। তারিখটি গ্রেগরিয়ান ক্যালেন্ডারের সাথে সম্পর্কিত। এটি নিম্নলিখিতগুলির মধ্যে একটি প্রতিনিধিত্ব করতে পারে:

  • একটি সম্পূর্ণ তারিখ, অ-শূন্য বছর, মাস এবং দিনের মান সহ।
  • একটি মাস এবং দিন, একটি শূন্য বছর সহ (উদাহরণস্বরূপ, একটি বার্ষিকী)।
  • একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি বছর নিজেই।
  • একটি বছর এবং মাস, একটি শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।

সম্পর্কিত প্রকার:

JSON প্রতিনিধিত্ব
{
  "year": integer,
  "month": integer,
  "day": integer
}
ক্ষেত্র
year

integer

তারিখের বছর। একটি বছর ছাড়া একটি তারিখ নির্দিষ্ট করতে 1 থেকে 9999, বা 0 হতে হবে।

month

integer

এক বছরের মাস। একটি মাস এবং দিন ছাড়া একটি বছর নির্দিষ্ট করতে 1 থেকে 12, বা 0 হতে হবে৷

day

integer

এক মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 নিজে থেকে একটি বছর বা একটি বছর এবং মাস উল্লেখ করতে হবে যেখানে দিনটি তাৎপর্যপূর্ণ নয়৷

চিত্রের গুণমান

কিছু API ফলাফল গণনা করতে ব্যবহৃত চিত্রের গুণমান।

দ্রষ্টব্য: চিত্রের মানের স্তর নির্বিশেষে, DSM আউটপুটগুলির সর্বদা 0.1 মিটার/পিক্সেলের রেজোলিউশন থাকে, মাসিক ফ্লাক্স আউটপুটগুলির সর্বদা 0.5 মিটার/পিক্সেলের একটি রেজোলিউশন থাকে এবং প্রতি ঘন্টার শেড আউটপুটগুলির সর্বদা 1 মিটার/পিক্সেলের রেজোলিউশন থাকে৷

এনামস
IMAGERY_QUALITY_UNSPECIFIED কোন গুণ জানা নেই.
HIGH অন্তর্নিহিত চিত্রাবলী এবং DSM ডেটা 0.1 m/pixel এ প্রক্রিয়া করা হয়েছিল।
MEDIUM অন্তর্নিহিত চিত্র এবং DSM ডেটা 0.25 মি/পিক্সেল এ প্রক্রিয়া করা হয়েছিল।
LOW অন্তর্নিহিত চিত্র এবং DSM ডেটা 0.5 মিটার/পিক্সেল এ প্রক্রিয়া করা হয়েছিল।

পদ্ধতি

get

একটি অবস্থানের আশেপাশের একটি অঞ্চলের জন্য সৌর তথ্য পায়।