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

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

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

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

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

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

একটি উচ্চতা API অনুরোধ নিম্নলিখিত ফর্ম নেয়:

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

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

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

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

পরামিতি অনুরোধ

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

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

সব অনুরোধ

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

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

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

নমুনা পাথ অনুরোধ

  • path ( প্রয়োজনীয় ) পৃথিবীতে একটি পথ সংজ্ঞায়িত করে যার জন্য উচ্চতার ডেটা ফেরত দিতে হবে। এই প্যারামিটারটি পৃথিবীর পৃষ্ঠ বরাবর একটি পথ সংজ্ঞায়িত করে দুই বা ততোধিক ক্রমযুক্ত {অক্ষাংশ, দ্রাঘিমাংশ} জোড়ার একটি সেটকে সংজ্ঞায়িত করে। এই প্যারামিটারটি অবশ্যই নীচে বর্ণিত 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 মধ্যে যে কোনও মান নিতে পারে। আপনি যদি একটি অবৈধ অক্ষাংশ বা দ্রাঘিমাংশের মান উল্লেখ করেন, আপনার অনুরোধটি একটি খারাপ অনুরোধ হিসাবে প্রত্যাখ্যান করা হবে৷

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

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

উচ্চতা প্রতিক্রিয়া

প্রতিটি বৈধ অনুরোধের জন্য, এলিভেশন পরিষেবা অনুরোধ URL-এর মধ্যে নির্দেশিত বিন্যাসে একটি উচ্চতা প্রতিক্রিয়া প্রদান করবে।

ElevationResponse

FieldRequiredTypeDescription
required Array< ElevationResult > See ElevationResult for more information.
required ElevationStatus See ElevationStatus for more information.
optionalstring

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 রেসপন্স অবজেক্টের মধ্যে একটি অতিরিক্ত error_message ক্ষেত্র থাকতে পারে। এই ক্ষেত্রটিতে প্রদত্ত স্থিতি কোডের পিছনের কারণগুলি সম্পর্কে আরও বিশদ তথ্য রয়েছে৷

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

ElevationResult

FieldRequiredTypeDescription
required number

The elevation of the location in meters.

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.

optionalnumber

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.

FieldRequiredTypeDescription
required number

Latitude in decimal degrees

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

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

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>

নিম্নলিখিত উদাহরণগুলি মাউন্ট হুইটনি, CA থেকে ব্যাডওয়াটার, CA, মহাদেশীয় মার্কিন যুক্তরাষ্ট্রের সর্বোচ্চ এবং সর্বনিম্ন বিন্দু পর্যন্ত সরলরেখার 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

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>