উচ্চতার অনুরোধ
এলিভেশন API অনুরোধগুলি একটি URL স্ট্রিং হিসাবে তৈরি করা হয়। API পৃথিবীর অবস্থানগুলির জন্য উচ্চতা ডেটা প্রদান করে। আপনি দুটি উপায়ের একটিতে অবস্থান ডেটা নির্দিষ্ট করুন:
- এক বা একাধিক
locations
সেট হিসাবে। - একটি
path
বরাবর সংযুক্ত পয়েন্ট একটি সিরিজ হিসাবে.
অবস্থান বা পথের শীর্ষবিন্দু সনাক্ত করতে এই পদ্ধতির যেকোন একটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে। এই দস্তাবেজটি এলিভেশন API URL-এর প্রয়োজনীয় বিন্যাস এবং উপলব্ধ পরামিতিগুলি বর্ণনা করে৷
উচ্চতা API সর্বোচ্চ নির্ভুলতার একক পয়েন্ট প্রশ্নের জন্য ডেটা প্রদান করে। একাধিক অবস্থানের সাথে জড়িত ব্যাচের প্রশ্নগুলি কম নির্ভুলতার সাথে ডেটা ফেরত দিতে পারে, বিশেষ করে যদি অবস্থানগুলিকে আলাদা করে ছড়িয়ে দেওয়া হয়, কারণ ডেটার কিছু মসৃণতা ঘটে।
একটি উচ্চতা API অনুরোধ নিম্নলিখিত ফর্ম নেয়:
https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters
যেখানে outputFormat
নিম্নলিখিত মানগুলির মধ্যে একটি হতে পারে:
-
json
(প্রস্তাবিত), জাভাস্ক্রিপ্ট অবজেক্ট নোটেশনে আউটপুট নির্দেশ করে (JSON); বা -
xml
, XML-এ আউটপুট নির্দেশ করে, একটি<ElevationResponse>
নোডের মধ্যে মোড়ানো।
দ্রষ্টব্য : বৈধ হওয়ার জন্য 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
Field | Required | Type | Description |
---|---|---|---|
| required | Array< ElevationResult > | See ElevationResult for more information. |
| required | ElevationStatus | See ElevationStatus for more information. |
| optional | string |
When the service returns a status code other than |
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
Field | Required | Type | Description |
---|---|---|---|
| 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. |
| 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 |
---|---|---|---|
| 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>
উচ্চতার অনুরোধ
এলিভেশন API অনুরোধগুলি একটি URL স্ট্রিং হিসাবে তৈরি করা হয়। API পৃথিবীর অবস্থানগুলির জন্য উচ্চতা ডেটা প্রদান করে। আপনি দুটি উপায়ের একটিতে অবস্থান ডেটা নির্দিষ্ট করুন:
- এক বা একাধিক
locations
সেট হিসাবে। - একটি
path
বরাবর সংযুক্ত পয়েন্ট একটি সিরিজ হিসাবে.
অবস্থান বা পথের শীর্ষবিন্দু সনাক্ত করতে এই পদ্ধতির যেকোন একটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে। এই দস্তাবেজটি এলিভেশন API URL-এর প্রয়োজনীয় বিন্যাস এবং উপলব্ধ পরামিতিগুলি বর্ণনা করে৷
উচ্চতা API সর্বোচ্চ নির্ভুলতার একক পয়েন্ট প্রশ্নের জন্য ডেটা প্রদান করে। একাধিক অবস্থানের সাথে জড়িত ব্যাচের প্রশ্নগুলি কম নির্ভুলতার সাথে ডেটা ফেরত দিতে পারে, বিশেষ করে যদি অবস্থানগুলিকে আলাদা করে ছড়িয়ে দেওয়া হয়, কারণ ডেটার কিছু মসৃণতা ঘটে।
একটি উচ্চতা API অনুরোধ নিম্নলিখিত ফর্ম নেয়:
https://maps.googleapis.com/maps/api/elevation/outputFormat?parameters
যেখানে outputFormat
নিম্নলিখিত মানগুলির মধ্যে একটি হতে পারে:
-
json
(প্রস্তাবিত), জাভাস্ক্রিপ্ট অবজেক্ট নোটেশনে আউটপুট নির্দেশ করে (JSON); বা -
xml
, XML-এ আউটপুট নির্দেশ করে, একটি<ElevationResponse>
নোডের মধ্যে মোড়ানো।
দ্রষ্টব্য : বৈধ হওয়ার জন্য 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
Field | Required | Type | Description |
---|---|---|---|
| required | Array< ElevationResult > | See ElevationResult for more information. |
| required | ElevationStatus | See ElevationStatus for more information. |
| optional | string |
When the service returns a status code other than |
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
Field | Required | Type | Description |
---|---|---|---|
| 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. |
| 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 |
---|---|---|---|
| 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>