সম্প্রসারিত কভারেজ (পরীক্ষামূলক)

এই পণ্য বা বৈশিষ্ট্যটি পরীক্ষামূলক (প্রি-GA)। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

Solar API একটি পরীক্ষামূলক বৈশিষ্ট্য চালু করছে যা পূর্বে অসমর্থিত অঞ্চলগুলিতে কভারেজ প্রসারিত করে, স্যাটেলাইট চিত্রগুলিতে প্রয়োগ করা মেশিন লার্নিং মডেলের উপর ভিত্তি করে। পরীক্ষামূলক সৌর ডেটা অ্যাক্সেস করতে, experiments পরামিতি EXPANDED_COVERAGE এ সেট করুন এবং requiredQuality প্যারামিটারটি BASE এ সেট করুন।

দ্রষ্টব্য: এই পরীক্ষার অধীনে শুধুমাত্র BASE মানের ডেটা পাওয়া যায়। experiments=EXPANDED_COVERAGE সহ Solar API কলগুলি পরীক্ষামূলক পর্যায়ে 100% ছাড় দেওয়া হয়৷ HIGH বা MEDIUM মানের ডেটা অ্যাক্সেস করতে, experiments=EXPANDED_COVERAGE প্যারামিটার৷ অ-পরীক্ষামূলক কলগুলি আদর্শ হারে বিল করা হবে৷

buildingInsights এবং dataLayers অনুরোধের জন্য পরীক্ষামূলক ডেটা উপলব্ধ। নিম্নলিখিত বিভাগ উদাহরণ অনুরোধ এবং প্রতিক্রিয়া বর্ণনা.

আপনার চাহিদা মেটাতে ডেটা এবং মডেলগুলিকে ক্রমাগত উন্নত করতে, সোলার এপিআই টিম এই পরীক্ষামূলক রিলিজে প্রতিক্রিয়া চাচ্ছে। আপনার প্রতিক্রিয়া শেয়ার করতে, Solar API টেস্টিং প্রোগ্রাম এক্সপেরিয়েন্স সার্ভেতে একটি প্রতিক্রিয়া জমা দিন বা Solar API: প্রসারিত কভারেজ ইস্যু ট্র্যাকারে একটি বাগ ফাইল করুন। সাম্প্রতিক ঘোষণার জন্য, [e-mail] ইমেল করে Solar API সম্প্রসারিত কভারেজ গ্রুপে যোগ দিন।

বিল্ডিং অন্তর্দৃষ্টি

বিল্ডিংইনসাইটস এন্ডপয়েন্ট একটি বিল্ডিংয়ের অবস্থান, মাত্রা এবং সৌর সম্ভাবনা সম্পর্কে অন্তর্দৃষ্টি প্রদান করে। বিল্ডিং অন্তর্দৃষ্টি অনুরোধ করতে, এখানে একটি HTTP GET অনুরোধ পাঠান:

https://solar.googleapis.com/v1/buildingInsights:findClosest?key=YOUR_API_KEY

আপনার অনুরোধ URL প্যারামিটারগুলি অন্তর্ভুক্ত করুন যা অবস্থানের অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক এবং ফলাফলগুলিতে অনুমোদিত ন্যূনতম প্রয়োজনীয় মানের স্তর নির্দিষ্ট করে৷

নিম্নলিখিত উদাহরণটি অক্ষাংশ = 4.655719 এবং দ্রাঘিমাংশ = -74.128971 এর স্থানাঙ্কে অবস্থানের জন্য অন্তর্দৃষ্টি তথ্যের জন্য অনুরোধ করে। পরীক্ষামূলক ডেটা অনুরোধ করতে, নিম্নলিখিত পরামিতি সেট করুন:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

দ্রষ্টব্য: BASE চিত্রের গুণমান ডেটা কেবলমাত্র তখনই উপলব্ধ হয় যদি experiments পরামিতি EXPANDED_COVERAGE এ সেট করা থাকে।

curl -X GET "https://solar.googleapis.com/v1/buildingInsights:findClosest?location.latitude=4.655719&location.longitude=-74.128971&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

এই অনুরোধটি ফর্মটিতে একটি JSON প্রতিক্রিয়া তৈরি করে:

{
  "name": "buildings/ChIJW2GaKXecP44RaeGtGpQtk4Q",
  "center": {
    "latitude": 4.6557664,
    "longitude": -74.1289303
  },
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "regionCode": "CO",
  "solarPotential": {
    "maxArrayPanelsCount": 351,
    "maxArrayAreaMeters2": 689.20776,
    "maxSunshineHoursPerYear": 1631.7008,
    "carbonOffsetFactorKgPerMwh": 122.99986,
    "wholeRoofStats": {
      "areaMeters2": 1078.406,
      "sunshineQuantiles": [
        562.9261,
        930.9767,
        1165.876,
        1221.8761,
        1333.0057,
        1485.7363,
        1563.2417,
        1593.266,
        1610.5652,
        1621.5986,
        1640.6102
      ],
      "groundAreaMeters2": 1050.76
    },
    "roofSegmentStats": [
      {
        "pitchDegrees": 38.58091,
        "azimuthDegrees": 41.91368,
        "stats": {
          "areaMeters2": 23.153826,
          "sunshineQuantiles": [
            582.9132,
            612.5797,
            673.3435,
            762.14233,
            899.41864,
            1031.1329,
            1103.8121,
            1135.5204,
            1150.2969,
            1158.215,
            1170.5475
          ],
          "groundAreaMeters2": 18.1
        },
        "center": {
          "latitude": 4.6554996,
          "longitude": -74.128966699999992
        },
        "boundingBox": {
          "sw": {
            "latitude": 4.655472,
            "longitude": -74.1290005
          },
          "ne": {
            "latitude": 4.6555371999999995,
            "longitude": -74.1289328
          }
        },
        "planeHeightAtCenterMeters": 2552.031
      },
      /.../
    ]
    "solarPanelConfigs": [
      {
        "panelsCount": 4,
        "yearlyEnergyDcKwh": 2609.5698,
        "roofSegmentSummaries": [
          {
            "pitchDegrees": 10.260736,
            "azimuthDegrees": 131.22626,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.84863,
            "segmentIndex": 6
          },
          {
            "pitchDegrees": 8.649131,
            "azimuthDegrees": 145.79407,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.3829,
            "segmentIndex": 11
          },
          {
            "pitchDegrees": 5.061984,
            "azimuthDegrees": 12.690001,
            "panelsCount": 2,
            "yearlyEnergyDcKwh": 1304.3383,
            "segmentIndex": 12
          }
        ]
      },
      /.../
    ]
    "panelCapacityWatts": 400,
    "panelHeightMeters": 1.879,
    "panelWidthMeters": 1.045,
    "panelLifetimeYears": 20,
    "buildingStats": {
      "areaMeters2": 1143.155,
      "sunshineQuantiles": [
        557,
        883.26263,
        1146.4794,
        1209.3063,
        1278.1102,
        1465.2921,
        1557.7494,
        1590.9565,
        1609.4994,
        1621.1909,
        1640.6102
      ],
      "groundAreaMeters2": 1089.35
    },
    "solarPanels": [
      {
        "center": {
          "latitude": 4.6560077,
          "longitude": -74.12885
        },
        "orientation": "PORTRAIT",
        "yearlyEnergyDcKwh": 653.14404,
        "segmentIndex": 12
      },
      /.../
    ]
    },
  "boundingBox": {
    "sw": {
      "latitude": 4.6554716,
      "longitude": -74.129243899999992
    },
    "ne": {
      "latitude": 4.6560513,
      "longitude": -74.128623900000008
    }
  },
  "imageryQuality": "BASE",
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  }
}

ডাটা লেয়ার

ডেটালেয়ার এন্ডপয়েন্ট একটি নির্দিষ্ট অবস্থানের আশেপাশের একটি অঞ্চলের জন্য বিশদ সৌর তথ্য প্রদান করে। এন্ডপয়েন্টটি 17টি ডাউনলোডযোগ্য TIFF ফাইল প্রদান করে, যার মধ্যে একটি ডিজিটাল সারফেস মডেল (DSM), RGB কম্পোজিট লেয়ার (এরিয়াল ইমেজরি), এবং একটি মাস্ক লেয়ার রয়েছে যা বিশ্লেষণের সীমানা চিহ্নিত করে।

নিম্নলিখিত উদাহরণটি dataLayers পদ্ধতিতে একটি REST অনুরোধের URL দেখায়:

https://solar.googleapis.com/v1/dataLayers:get?parameters

আপনার অনুরোধের URL প্যারামিটারগুলি অন্তর্ভুক্ত করুন যা নিম্নলিখিতগুলি নির্দিষ্ট করে:

• অবস্থানের অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক
• অবস্থানের পার্শ্ববর্তী অঞ্চলের ব্যাসার্ধ (মিটারে)
• ফলাফলে অনুমোদিত ন্যূনতম গুণমান

পরীক্ষামূলক ডেটা অনুরোধ করতে, নিম্নলিখিত পরামিতি সেট করুন:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=4.655719&location.longitude=-74.128971&radiusMeters=100&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

এই অনুরোধটি ফর্মটিতে একটি JSON প্রতিক্রিয়া তৈরি করে:

{
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=MWU2NmYxNmU3M2JlYmY5NDJkZmVmMjQ0NDViMjFjYTgtZWVhYjRiN2U0YWJlNzM2Nzk1MzUxZTQ4YTgxNjZiM2M6UkdCOkJBU0U",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ZGU4NzhmNDg0YjE2OGYwYTdjN2EyYmVlMDQxYTM5NDMtNDk2NGQwNzBhMzAwYzBkYTEwZDNmYjgzNTk4ODkyY2I6TUFTSzpCQVNF",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NmRiZDQ0NDFkNWE5NDU2Nzc2ZTU1Mzg0MDY0YzFhMWMtMDg2ZDMyZjVkYTMzMDhiZmI5NzM1MzY0YmRjZmFiM2I6QU5OVUFMX0ZMVVg6QkFTRQ",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NTAyMDJkMTVmMjJiZGYyOTNiMDFhMWEzNDJkZjAwNTctZDRjMjY3ZjU1YjQ2ZjE4ZTNkNjE1YmU5NTlmOThlZjM6TU9OVEhMWV9GTFVYOkJBU0U",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=NWNkZmM0NTcwYTE5ODQzMmI0MmQ1NDM4NzY4MTc5MzEtOWE0MTBjNDkwM2IxZjA0MmI1ZTNmNTg1NTY0MTNkZjI6SE9VUkxZX1NIQURFOkJBU0U",
    "https://solar.googleapis.com/v1/geoTiff:get?id=Y2YwNDY4MzQ1YzhkMjBlZjU5M2NiNDRmMmM0ODRiNTUtNjMwOWM2NDBjZmI5OTdkMDA3ZGQzOWY2YmI1ZTk2NWM6SE9VUkxZX1NIQURFOkJBU0U",
    /.../
  ],
  "imageryQuality": "BASE"
}

প্রতিক্রিয়াতে URL-এ একটি অনুরোধ করতে, URL-এ আপনার API কী যুক্ত করুন:

curl -X GET "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U&key=YOUR_API_KEY"

আরজিবি লেয়ার বাদে, সমস্ত টিআইএফএফ ফাইল ইমেজ ভিউয়ার অ্যাপ্লিকেশনে ফাঁকা ছবি হিসেবে প্রদর্শিত হবে। ডাউনলোড করা TIFF ফাইলগুলি দেখতে, সেগুলিকে একটি ম্যাপিং অ্যাপ্লিকেশন সফ্টওয়্যারে আমদানি করুন, যেমন QGIS৷

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

দ্রষ্টব্য: প্রাথমিক অনুরোধের পরে প্রতিক্রিয়া URLগুলি শুধুমাত্র এক ঘন্টার জন্য সক্রিয় থাকে৷ এই সময়সীমার বাইরে ইউআরএল অ্যাক্সেস করতে, আপনাকে অবশ্যই dataLayers এন্ডপয়েন্টে আবার একটি অনুরোধ পাঠাতে হবে।