এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

উচ্চতার অনুরোধ এবং প্রতিক্রিয়া

উচ্চতার অনুরোধ

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

এক বা একাধিক locations একটি সেট হিসাবে।
একটি path বরাবর সংযুক্ত বিন্দুর একটি সিরিজ হিসাবে।

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

এলিভেশন এপিআই সর্বোচ্চ নির্ভুলতার একক বিন্দু প্রশ্নের জন্য ডেটা ফেরত দেয়। একাধিক অবস্থানের সাথে জড়িত ব্যাচের প্রশ্নগুলি কম নির্ভুলতার সাথে ডেটা ফেরত দিতে পারে, বিশেষ করে যদি অবস্থানগুলি আলাদাভাবে ছড়িয়ে থাকে, কারণ ডেটার কিছু স্মুথিং ঘটে।

একটি এলিভেশন এপিআই অনুরোধ নিম্নলিখিত ফর্মটি গ্রহণ করে:

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

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

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

দ্রষ্টব্য : URL গুলি সঠিকভাবে এনকোড করা আবশ্যক যাতে এটি বৈধ হয় এবং সমস্ত ওয়েব পরিষেবার জন্য 16384 অক্ষরের মধ্যে সীমাবদ্ধ থাকে। আপনার URL গুলি তৈরি করার সময় এই সীমা সম্পর্কে সচেতন থাকুন। মনে রাখবেন যে বিভিন্ন ব্রাউজার, প্রক্সি এবং সার্ভারেরও বিভিন্ন URL অক্ষর সীমা থাকতে পারে।

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

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

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

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

সকল অনুরোধ

key — ( প্রয়োজনীয় ) আপনার অ্যাপ্লিকেশনের API কী। এই কীটি কোটা ব্যবস্থাপনার উদ্দেশ্যে আপনার অ্যাপ্লিকেশনটিকে শনাক্ত করে। কীভাবে কী পেতে হয় তা জানুন।

অবস্থানগত অনুরোধ

locations ( প্রয়োজনীয় ) পৃথিবীর অবস্থান(গুলি) নির্ধারণ করে যেখান থেকে উচ্চতার তথ্য ফেরত পাঠানো হবে। এই প্যারামিটারটি একটি একক অবস্থানকে কমা দ্বারা পৃথক করা {latitude,longitude} জোড়া (যেমন "40.714728,-73.998672") হিসেবে গ্রহণ করে অথবা একাধিক অক্ষাংশ/দ্রাঘিমাংশ জোড়াকে একটি অ্যারে হিসেবে অথবা একটি এনকোডেড পলিলাইন হিসেবে গ্রহণ করে। এই নির্দিষ্ট প্যারামিটারের জন্য 512 পয়েন্টের সীমা রয়েছে। আরও তথ্যের জন্য, নীচে অবস্থান নির্দিষ্টকরণ দেখুন।

নমুনাকৃত পথের অনুরোধ

path ( প্রয়োজনীয় ) পৃথিবীর উপর এমন একটি পথ নির্ধারণ করে যার জন্য উচ্চতার তথ্য ফেরত দেওয়া হবে। এই প্যারামিটারটি পৃথিবীর পৃষ্ঠ বরাবর একটি পথ নির্ধারণ করে এমন দুই বা ততোধিক ক্রমযুক্ত {latitude,longitude} জোড়ার একটি সেট সংজ্ঞায়িত করে। এই প্যারামিটারটি নীচে বর্ণিত samples প্যারামিটারের সাথে একত্রে ব্যবহার করা আবশ্যক। এই নির্দিষ্ট প্যারামিটারের জন্য 512 পয়েন্টের সীমা রয়েছে। আরও তথ্যের জন্য, নীচের নির্দিষ্টকরণ পথগুলি দেখুন।
samples ( প্রয়োজনীয় ) একটি পথের উপর কতগুলি নমুনা বিন্দুর সংখ্যা নির্দেশ করে যার জন্য উচ্চতার তথ্য ফেরত দেওয়া হবে। samples প্যারামিটার প্রদত্ত path পথের উপর সমান দূরত্বের বিন্দুর একটি ক্রমিক সেটে বিভক্ত করে।

অবস্থান নির্দিষ্ট করা

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

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

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

অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক স্ট্রিংগুলি কমা দ্বারা পৃথক করা টেক্সট স্ট্রিংয়ের মধ্যে সংখ্যা ব্যবহার করে সংজ্ঞায়িত করা হয়। উদাহরণস্বরূপ, "40.714728,-73.998672" হল একটি বৈধ locations মান। অক্ষাংশ এবং দ্রাঘিমাংশের মানগুলি পৃথিবীর পৃষ্ঠের একটি বৈধ অবস্থানের সাথে সঙ্গতিপূর্ণ হতে হবে। অক্ষাংশ -90 এবং 90 এর মধ্যে যেকোনো মান নিতে পারে যখন দ্রাঘিমাংশের মান -180 এবং 180 এর মধ্যে যেকোনো মান নিতে পারে। যদি আপনি একটি অবৈধ অক্ষাংশ বা দ্রাঘিমাংশের মান উল্লেখ করেন, তাহলে আপনার অনুরোধটি একটি খারাপ অনুরোধ হিসাবে প্রত্যাখ্যাত হবে।

একটি বৈধ URL তৈরি করার সময়, আপনি একটি অ্যারে বা এনকোডেড পলিলাইনের মধ্যে 512টি স্থানাঙ্ক পর্যন্ত পাস করতে পারেন। মনে রাখবেন যে একাধিক স্থানাঙ্ক পাস করার সময়, কোনও ফেরত ডেটার নির্ভুলতা একটি একক স্থানাঙ্কের জন্য ডেটা অনুরোধ করার চেয়ে কম রেজোলিউশনের হতে পারে। 'অবস্থান' বা 'পথ' প্যারামিটারে 512 পয়েন্ট বা স্থানাঙ্ক অতিক্রম করলে একটি 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-এর মধ্যে নির্দেশিত বিন্যাসে একটি এলিভেশন প্রতিক্রিয়া প্রদান করবে।

ElevationResponse

Field	Required	Type	Description
`results`	required	Array< ElevationResult >	See ElevationResult for more information.
`status`	required	ElevationStatus	See ElevationStatus for more information.
`error_message`	optional	string	When the service returns a status code other than `OK` , there may be an additional `error_message` field within the response object. This field contains more detailed information about thereasons behind the given status code. This field is not always returned, and its content is subject to change.

ElevationStatus

Status codes returned by service.

OK indicating the API request was successful.
DATA_NOT_AVAILABLE indicating that there's no available data for the input locations.
INVALID_REQUEST indicating the API request was malformed.
OVER_DAILY_LIMIT indicating any of the following:
- The API key is missing or invalid.
- Billing has not been enabled on your account.
- A self-imposed usage cap has been exceeded.
- The provided method of payment is no longer valid (for example, a credit card has expired).
OVER_QUERY_LIMIT indicating the requestor has exceeded quota.
REQUEST_DENIED indicating the API did not complete the request.
UNKNOWN_ERROR indicating an unknown error.

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

প্রতিক্রিয়াটিতে নিম্নলিখিত উপাদানগুলির সাথে একটি results অ্যারে রয়েছে:

ElevationResult

Field	Required	Type	Description
`elevation`	required	number	The elevation of the location in meters.
`location`	required	LatLngLiteral	A location element of the position for which elevation data is being computed. Note that for path requests, the set of location elements will contain the sampled points along the path. See LatLngLiteral for more information.
`resolution`	optional	number	The value indicating the maximum distance between data points from which the elevation was interpolated, in meters. This property will be missing if the resolution is not known. Note that elevation data becomes more coarse (larger resolution values) when multiple points are passed. To obtain the most accurate elevation value for a point, it should be queried independently.

location বস্তুতে নিম্নলিখিত উপাদানগুলি রয়েছে:

LatLngLiteral

An object describing a specific location with Latitude and Longitude in decimal degrees.

Field	Required	Type	Description
`lat`	required	number	Latitude in decimal degrees
`lng`	required	number	Longitude in decimal degrees

অবস্থানগত উচ্চতার উদাহরণ

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

URL টি

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'

JSON সম্পর্কে

{
  "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>

নিম্নলিখিত উদাহরণটি একাধিক প্রতিক্রিয়া দেখায় (ডেনভার, CO এবং ডেথ ভ্যালি, CA এর জন্য)।

এই অনুরোধটি JSON output পতাকা ব্যবহার করে দেখায়:

URL টি

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 প্রতিক্রিয়া দেখতে নিচের ট্যাবগুলি নির্বাচন করুন।

JSON সম্পর্কে

{
  "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 চাইছি, যাতে দুটি শেষবিন্দু এবং অর্ধেক বিন্দু অন্তর্ভুক্ত থাকবে।

URL টি

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'

JSON সম্পর্কে

{
  "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>

উচ্চতার অনুরোধ এবং প্রতিক্রিয়া