এলিভেশন সংক্রান্ত অনুরোধ ও উত্তর

উচ্চতা সম্পর্কিত অনুরোধ

Elevation API অনুরোধ URL স্ট্রিং হিসেবে তৈরি করা হয়। API পৃথিবীর বিভিন্ন লোকেশনের জন্য এলিভেশন ডেটা রিটার্ন করে। আপনি দুটি উপায়ের মধ্যে একটির মাধ্যমে লোকেশন ডেটা নির্দিষ্ট করেন:

• এক বা একাধিক locations-এর সেট হিসেবে।
• path বরাবর কানেক্ট করা পয়েন্টের সিরিজ হিসেবে।

এই দুটি পদ্ধতির যেকোনও একটি লোকেশন বা পথের শীর্ষবিন্দু শনাক্ত করতে অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট ব্যবহার করে। এই ডকুমেন্ট Elevation API URL-এর প্রয়োজনীয় ফর্ম্যাট এবং উপলভ্য প্যারামিটার সম্পর্কে বর্ণনা করে।

Elevation API, সর্বাধিক সম্ভাব্য নির্ভুলতার সাথে সিঙ্গেল পয়েন্ট কোয়েরির জন্য ডেটা রিটার্ন করে। একাধিক লোকেশন সহ ব্যাচ কোয়েরি কম নির্ভুলতার সাথে ডেটা ফেরত দিতে পারে, বিশেষ করে যদি লোকেশনগুলি দূরে দূরে ছড়িয়ে থাকে, কারণ ডেটা কিছুটা স্মুথিং হয়।

Elevation API অনুরোধ নিম্নলিখিত ফর্ম গ্রহণ করে:

https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters

যেখানে outputFormat নিম্নলিখিত মানগুলির মধ্যে যেকোনও একটি হতে পারে:

• json (সাজেস্ট করা), যা জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন (JSON)-এ আউটপুট দেখায়; অথবা
• xml, XML-এ আউটপুট দেখায়, যা <ElevationResponse> নোডের মধ্যে র‍্যাপ করা থাকে।

মনে রাখবেন: URL সঠিক হতে হলে সেটিকে সঠিকভাবে এনকোড করতে হবে এবং সব ওয়েব পরিষেবার জন্য ১৬৩৮৪ অক্ষরের মধ্যে সীমাবদ্ধ হতে হবে। URL তৈরি করার সময় এই সীমার কথা মাথায় রাখবেন। মনে রাখবেন, বিভিন্ন ব্রাউজার, প্রক্সি ও সার্ভারে URL-এর অক্ষর সীমার ক্ষেত্রেও পার্থক্য থাকতে পারে।

API কী ব্যবহার করে এমন অনুরোধের জন্য HTTPS প্রয়োজন।

অনুরোধের প্যারামিটার

এলিভেশন API-তে করা অনুরোধে বিভিন্ন প্যারামিটার ব্যবহার করা হয়। অনুরোধটি বিচ্ছিন্ন লোকেশন নাকি কোনও অর্ডার করা পাথের জন্য, তার উপর ভিত্তি করে এটি করা হয়। আলাদা আলাদা লোকেশনের জন্য, উচ্চতা সংক্রান্ত অনুরোধ অনুরোধে পাস করা নির্দিষ্ট লোকেশনের ডেটা ফেরত দেয়; পাথের জন্য, উচ্চতা সংক্রান্ত অনুরোধের পরিবর্তে প্রদত্ত পাথ বরাবর স্যাম্পেল করা হয়।

সব URL-এর স্ট্যান্ডার্ড অনুযায়ী, প্যারামিটারগুলি অ্যাম্পারস্যান্ড (&) অক্ষর ব্যবহার করে আলাদা করা হয়। প্যারামিটারের তালিকা এবং সেগুলির সম্ভাব্য ভ্যালু নিচে উল্লেখ করা হল।

সব অনুরোধ

• key -- (প্রয়োজন) আপনার অ্যাপ্লিকেশনের API কী। এই 'কী' কোটা ম্যানেজমেন্টের উদ্দেশ্যে আপনার অ্যাপ্লিকেশন শনাক্ত করে। কীভাবে কী পাবেন তা জানুন।

পজিশনাল অনুরোধ

• locations (প্রয়োজনীয়) পৃথিবীর সেইসব লোকেশনকে নির্দিষ্ট করে যেখান থেকে এলিভেশন ডেটা পাওয়া যাবে। এই প্যারামিটারটি কমা দ্বারা পৃথক করা {অক্ষাংশ,দ্রাঘিমাংশ} জোড়া হিসাবে একটি একক অবস্থান নেয় (যেমন "৪০.৭১৪৭২৮,-৭৩.৯৯৮৬৭২") বা একাধিক অক্ষাংশ/দ্রাঘিমাংশ জোড়া একটি অ্যারে হিসাবে বা একটি এনকোড করা পলিলাইন হিসাবে পাস করা হয়েছে। এই নির্দিষ্ট প্যারামিটারের জন্য ৫১২ পয়েন্টের সীমা আছে। আরও তথ্যের জন্য, নিচে লোকেশন নির্দিষ্ট করুন দেখুন।

স্যাম্পেল করা পাথ সংক্রান্ত অনুরোধ

• path (প্রয়োজনীয়) পৃথিবীর এমন একটি পাথকে সংজ্ঞায়িত করে যার জন্য এলিভেশন ডেটা রিটার্ন করতে হবে। এই প্যারামিটারটি দুই বা ততোধিক {অক্ষাংশ,দ্রাঘিমাংশ} জোড়ার একটি সেটকে সংজ্ঞায়িত করে যা পৃথিবীর পৃষ্ঠ বরাবর একটি পথকে সংজ্ঞায়িত করে। এই প্যারামিটারটি অবশ্যই নিচে বর্ণিত samples প্যারামিটারের সাথে একত্রে ব্যবহার করতে হবে। এই নির্দিষ্ট প্যারামিটারের জন্য ৫১২ পয়েন্টের সীমা আছে। আরও তথ্যের জন্য, নিচে পাথ নির্দিষ্ট করুন বিকল্প দেখুন।
• samples (প্রয়োজন) কোনও পাথ বরাবর স্যাম্পেল পয়েন্টের সংখ্যা নির্দিষ্ট করে যার জন্য এলিভেশন ডেটা রিটার্ন করতে হবে। samples প্যারামিটারটি প্রদত্ত path-কে পাথ বরাবর সমান দূরত্বের পয়েন্টের একটি ক্রমিক সেটে ভাগ করে।

লোকেশন উল্লেখ করুন

পজিশনাল অনুরোধগুলি locations প্যারামিটার ব্যবহারের মাধ্যমে নির্দেশ করা হয়, যা অক্ষাংশ/দ্রাঘিমাংশ মান হিসাবে পাস করা নির্দিষ্ট লোকেশনের জন্য উচ্চতা সংক্রান্ত অনুরোধ নির্দেশ করে।

locations প্যারামিটার নিম্নলিখিত আর্গুমেন্ট নিতে পারে:

• একটি কোঅর্ডিনেট: locations=40.714728,-73.998672
• পাইপ ('|') অক্ষর ব্যবহার করে আলাদা করা কোঅর্ডিনেটের অ্যারে: locations=40.714728,-73.998672|-34.397,150.644
• এনকোডেড পলিলাইন অ্যালগরিদম ব্যবহার করে এনকোড করা কোঅর্ডিনেটের সেট: locations=enc:gfo}EtohhU

অক্ষাংশ ও দ্রাঘিমাংশের স্থানাঙ্ক স্ট্রিং কমা দ্বারা আলাদা করা টেক্সট স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয়। যেমন, "৪০.৭১৪৭২৮,-৭৩.৯৯৮৬৭২" হল একটি সঠিক locations ভ্যালু। অক্ষাংশ ও দ্রাঘিমাংশের মান অবশ্যই পৃথিবীর পৃষ্ঠের একটি সঠিক লোকেশনের সাথে সম্পর্কিত হতে হবে। অক্ষাংশের মান -90 থেকে 90-এর মধ্যে যেকোনও সংখ্যা হতে পারে এবং দ্রাঘিমাংশের মান -180 থেকে 180-এর মধ্যে যেকোনও সংখ্যা হতে পারে। আপনি যদি ভুল অক্ষাংশ বা দ্রাঘিমাংশের ভ্যালু উল্লেখ করেন, তাহলে আপনার অনুরোধ খারাপ অনুরোধ হিসেবে বাতিল করা হবে।

আপনি একটি অ্যারে বা এনকোড করা পলিলাইনের মধ্যে সর্বাধিক ৫১২টি স্থানাঙ্ক পাস করতে পারেন, যদিও এখনও একটি সঠিক URL তৈরি করা হচ্ছে। মনে রাখবেন যে একাধিক স্থানাঙ্ক পাস করার সময়, ফেরত আসা যেকোনও ডেটার নির্ভুলতা একটি একক স্থানাঙ্কের জন্য ডেটার অনুরোধ করার চেয়ে কম রেজোলিউশনের হতে পারে। 'locations' বা 'path' প্যারামিটারে ৫১২ পয়েন্ট বা কোঅর্ডিনেটের বেশি হলে, INVALID_REQUEST রেসপন্স রিটার্ন করে।

পাথগুলি নির্দিষ্টভাবে উল্লেখ করা

path এবং samples প্যারামিটার ব্যবহার করে স্যাম্পেল করা পাথ সংক্রান্ত অনুরোধ দেখানো হয়, যা নির্দিষ্ট বিরতিতে কোনও পাথ বরাবর এলিভেশন ডেটার জন্য অনুরোধকে নির্দেশ করে। locations প্যারামিটার ব্যবহার করে পজিশনাল অনুরোধের মতো, path প্যারামিটার অক্ষাংশ ও দ্রাঘিমাংশের মানের একটি সেট নির্দিষ্ট করে। তবে, পজিশনাল অনুরোধের মতো নয়, path ভার্টিসেসের একটি অর্ডার করা সেট নির্দিষ্ট করে। শুধু ভার্টিসেসে উচ্চতা সম্পর্কিত ডেটা দেখানোর পরিবর্তে, পাথ সংক্রান্ত অনুরোধ পাথের দৈর্ঘ্য অনুযায়ী স্যাম্পেল করা হয়, এটি নির্দিষ্ট করা samples-এর সংখ্যার উপর ভিত্তি করে করা হয় (এন্ডপয়েন্ট সহ)।

path প্যারামিটার নিম্নলিখিত আর্গুমেন্টের যেকোনও একটি নিতে পারে:

• পাইপ ('|') অক্ষর ব্যবহার করে আলাদা করা দুই বা তার বেশি কমা দ্বারা আলাদা করা কোঅর্ডিনেট টেক্সট স্ট্রিংয়ের অ্যারে: path=40.714728,-73.998672|-34.397,150.644
• এনকোড করা পলিলাইন অ্যালগরিদম ব্যবহার করে এনকোড করা কোঅর্ডিনেট: path=enc:gfo}EtohhUxD@bAxJmGF

অক্ষাংশ ও দ্রাঘিমাংশের কোঅর্ডিনেট স্ট্রিং কমা দ্বারা আলাদা করা টেক্সট স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয়। যেমন, "40.714728,-73.998672|-34.397, 150.644" হল একটি সঠিক path ভ্যালু। অক্ষাংশ ও দ্রাঘিমাংশের মান অবশ্যই পৃথিবীর কোনও সঠিক লোকেশনের সাথে মিলতে হবে। অক্ষাংশের মান -90 থেকে 90-এর মধ্যে যেকোনও সংখ্যা হতে পারে এবং দ্রাঘিমাংশের মান -180 থেকে 180-এর মধ্যে যেকোনও সংখ্যা হতে পারে। আপনি যদি ভুল অক্ষাংশ বা দ্রাঘিমাংশের ভ্যালু নির্দিষ্ট করেন, তাহলে আপনার অনুরোধ খারাপ অনুরোধ হিসেবে বাতিল করা হবে।

আপনি একটি অ্যারে বা এনকোড করা পলিলাইনের মধ্যে সর্বাধিক ৫১২টি স্থানাঙ্ক পাস করতে পারেন, তবে এখনও একটি সঠিক URL তৈরি করা হচ্ছে। মনে রাখবেন যে একাধিক স্থানাঙ্ক পাস করার সময়, ফেরত আসা যেকোনও ডেটার নির্ভুলতা একটি একক স্থানাঙ্কের জন্য ডেটার অনুরোধ করার চেয়ে কম রেজোলিউশনের হতে পারে। 'locations' বা 'path' প্যারামিটারে ৫১২ পয়েন্ট বা কোঅর্ডিনেটের বেশি হলে INVALID_REQUEST রেসপন্স দেখায়।

উচ্চতা সংক্রান্ত উত্তর

• পাইপ ('|') অক্ষর ব্যবহার করে আলাদা করা দুই বা তার বেশি কমা দ্বারা আলাদা করা কোঅর্ডিনেট টেক্সট স্ট্রিংয়ের অ্যারে: path=40.714728,-73.998672|-34.397,150.644
• এনকোড করা পলিলাইন অ্যালগরিদম ব্যবহার করে এনকোড করা কোঅর্ডিনেট: path=enc:gfo}EtohhUxD@bAxJmGF

অক্ষাংশ ও দ্রাঘিমাংশের কোঅর্ডিনেট স্ট্রিং কমা দ্বারা আলাদা করা টেক্সট স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয়। যেমন, "40.714728,-73.998672|-34.397, 150.644" হল একটি সঠিক path ভ্যালু। অক্ষাংশ ও দ্রাঘিমাংশের মান অবশ্যই পৃথিবীর কোনও সঠিক লোকেশনের সাথে মিলতে হবে। অক্ষাংশের মান -90 থেকে 90-এর মধ্যে যেকোনও সংখ্যা হতে পারে এবং দ্রাঘিমাংশের মান -180 থেকে -180-এর মধ্যে যেকোনও সংখ্যা হতে পারে। আপনি যদি ভুল অক্ষাংশ বা দ্রাঘিমাংশের ভ্যালু নির্দিষ্ট করেন, তাহলে আপনার অনুরোধ খারাপ অনুরোধ হিসেবে বাতিল করা হবে।

আপনি একটি অ্যারে বা এনকোড করা পলিলাইনের মধ্যে সর্বাধিক ৫১২টি স্থানাঙ্ক পাস করতে পারেন, তবে এখনও একটি সঠিক URL তৈরি করা হচ্ছে। মনে রাখবেন যে একাধিক স্থানাঙ্ক পাস করার সময়, ফেরত আসা যেকোনও ডেটার নির্ভুলতা একটি একক স্থানাঙ্কের জন্য ডেটার অনুরোধ করার চেয়ে কম রেজোলিউশনের হতে পারে। 'locations' বা 'path' প্যারামিটারে ৫১২ পয়েন্ট বা কোঅর্ডিনেটের বেশি হলে INVALID_REQUEST রেসপন্স দেখায়।

উচ্চতা সংক্রান্ত উত্তর

প্রতিটি সঠিক অনুরোধের জন্য, Elevation পরিষেবা অনুরোধের URL-এ উল্লেখ করা ফর্ম্যাটে Elevation উত্তর প্রদান করে।

ElevationResponse

ElevationStatus

পরিষেবা থেকে স্ট্যাটাস কোড পাঠানো হয়েছে।

• OK API অনুরোধ সফল হয়েছে তা নির্দেশ করছে।
• DATA_NOT_AVAILABLE দেখাচ্ছে যে ইনপুট লোকেশনের জন্য কোনও ডেটা উপলভ্য নেই।
• INVALID_REQUEST থেকে বোঝা যায় যে API অনুরোধটি ভুলভাবে ফর্ম্যাট করা হয়েছে।
• OVER_DAILY_LIMIT নিম্নলিখিত যেকোনও একটি নির্দেশ করে:
  • API কী নেই বা ভুল।
  • আপনার অ্যাকাউন্টে বিলিং চালু করা হয়নি।
  • ব্যবহারের ক্ষেত্রে নিজের উপর আরোপ করা সীমা অতিক্রম করা হয়েছে।
  • প্রদান করা পেমেন্ট পদ্ধতি আর বৈধ নয় (যেমন, ক্রেডিট কার্ডের মেয়াদ শেষ হয়ে গেছে)।
• OVER_QUERY_LIMIT থেকে বোঝা যায় যে অনুরোধকারী কোটা অতিক্রম করেছেন।
• REQUEST_DENIED থেকে বোঝা যায় যে API অনুরোধ সম্পূর্ণ করেনি।
• UNKNOWN_ERROR অজানা সমস্যার কথা জানাচ্ছে।

স্ট্যাটাস কোড OK ছাড়া অন্য কিছু হলে, Elevation রেসপন্স অবজেক্টের মধ্যে অতিরিক্ত error_message ফিল্ড থাকতে পারে। এই ফিল্ডে প্রদত্ত স্ট্যাটাস কোডের কারণ সম্পর্কে আরও বিস্তারিত তথ্য থাকে।

উত্তরে নিম্নলিখিত এলিমেন্ট সহ একটি results অ্যারে থাকে:

ElevationResult

LatLngLiteral

দশমিক ডিগ্রিতে অক্ষাংশ এবং দ্রাঘিমাংশ সহ একটি নির্দিষ্ট লোকেশন বর্ণনা করে এমন একটি অবজেক্ট।

পজিশনাল এলিভেশনের উদাহরণ

নিম্নলিখিত উদাহরণে "মাইল হাই সিটি" ডেনভার, কলোরাডোর উচ্চতা সম্পর্কে অনুরোধ করা হয়েছে:

https://maps.googleapis.com/maps/api/elevation/json
    ?locations=39.7391536%2C-104.9847034
    &key=YOUR_API_KEY
      

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
      

        
{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
    ],
  "status": "OK",
}
        
        

        
<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
</ElevationResponse>
        
        

নিচের উদাহরণে একাধিক উত্তর দেখানো হয়েছে (ডেনভার, কলোরাডো এবং ডেথ ভ্যালি, ক্যালিফোর্নিয়ার জন্য)।

এই অনুরোধ JSON output ফ্ল্যাগ ব্যবহার করে দেখায়:

https://maps.googleapis.com/maps/api/elevation/json
    ?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667
    &key=YOUR_API_KEY
      

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034%7C36.455556%2C-116.866667&key=YOUR_API_KEY'
      

এই অনুরোধ XML output ফ্ল্যাগ ব্যবহার করে দেখায়:

https://maps.googleapis.com/maps/api/elevation/xml?locations=39.7391536,-104.9847034|36.455556,-116.866667&key=YOUR_API_KEY

স্যাম্পেল JSON ও XML উত্তর দেখতে নিচের ট্যাব বেছে নিন।

      
{
  "results":
    [
      {
        "elevation": 1608.637939453125,
        "location": { "lat": 39.7391536, "lng": -104.9847034 },
        "resolution": 4.771975994110107,
      },
      {
        "elevation": -52.79492568969727,
        "location": { "lat": 36.455556, "lng": -116.866667 },
        "resolution": 19.08790397644043,
      },
    ],
  "status": "OK",
}
      
      

      
<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>39.7391536</lat>
   <lng>-104.9847034</lng>
  </location>
  <elevation>1608.6379395</elevation>
  <resolution>4.7719760</resolution>
 </result>
 <result>
  <location>
   <lat>36.4555560</lat>
   <lng>-116.8666670</lng>
  </location>
  <elevation>-52.7949257</elevation>
  <resolution>19.0879040</resolution>
 </result>
</ElevationResponse>
      
      

নিম্নলিখিত উদাহরণে মাউন্ট হুইটনি, ক্যালিফোর্নিয়া থেকে ব্যাডওয়াটার, ক্যালিফোর্নিয়া পর্যন্ত একটি সরলরেখা বরাবর path উচ্চতা সম্পর্কিত ডেটার অনুরোধ করা হয়েছে। এই দুটি স্থান যথাক্রমে মার্কিন যুক্তরাষ্ট্রের মূল ভূখণ্ডের সর্বোচ্চ এবং সর্বনিম্ন বিন্দু। আমরা তিনটি samples চাই, যাতে দুটি এন্ডপয়েন্ট এবং হাফওয়ে পয়েন্ট অন্তর্ভুক্ত থাকে।

https://maps.googleapis.com/maps/api/elevation/json
  ?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171
  &samples=3
  &key=YOUR_API_KEY
    

curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?path=36.578581%2C-118.291994%7C36.23998%2C-116.83171&samples=3&key=YOUR_API_KEY'
    

      
{
  "results":
    [
      {
        "elevation": 4411.94189453125,
        "location": { "lat": 36.578581, "lng": -118.291994 },
        "resolution": 19.08790397644043,
      },
      {
        "elevation": 1372.8359375,
        "location": { "lat": 36.41150289067028, "lng": -117.5602607523847 },
        "resolution": 9.543951988220215,
      },
      {
        "elevation": -84.51690673828125,
        "location": { "lat": 36.23998, "lng": -116.83171 },
        "resolution": 9.543951988220215,
      },
    ],
  "status": "OK",
}
      
      

      
<ElevationResponse>
 <status>OK</status>
 <result>
  <location>
   <lat>36.5785810</lat>
   <lng>-118.2919940</lng>
  </location>
  <elevation>4411.9418945</elevation>
  <resolution>19.0879040</resolution>
 </result>
 <result>
  <location>
   <lat>36.4115029</lat>
   <lng>-117.5602608</lng>
  </location>
  <elevation>1372.8359375</elevation>
  <resolution>9.5439520</resolution>
 </result>
 <result>
  <location>
   <lat>36.2399800</lat>
   <lng>-116.8317100</lng>
  </location>
  <elevation>-84.5169067</elevation>
  <resolution>9.5439520</resolution>
 </result>
</ElevationResponse>