ऊंचाई के अनुरोध और जवाब

ऊंचाई के अनुरोध

एलिवेशन एपीआई अनुरोध यूआरएल स्ट्रिंग के तौर पर बनाए जाते हैं. एपीआई पृथ्वी पर स्थानों के लिए ऊंचाई डेटा देता है. आप स्थान डेटा दर्ज करें इन दो में से किसी एक तरीके से:

  • एक या ज़्यादा locations के सेट के तौर पर.
  • path पर कनेक्ट किए गए पॉइंट की सीरीज़ के तौर पर.

इनमें से कोई भी तरीका अक्षांश/देशांतर निर्देशांकों का इस्तेमाल स्थानों या पथ के शीर्षों पर नज़र रखें. इस दस्तावेज़ में इसके आवश्यक प्रारूप की जानकारी दी गई है एलिवेशन एपीआई के यूआरएल और उपलब्ध पैरामीटर.

एलिवेशन एपीआई, सिंगल पॉइंट क्वेरी के लिए डेटा दिखाता है सबसे सटीक नतीजे देता है. एक से ज़्यादा जगहों से जुड़ी बैच क्वेरी ऐसा हो सकता है कि कम सटीक डेटा के साथ डेटा दिखे. खास तौर पर तब, जब अलग-अलग जगहों पर अलग से, क्योंकि डेटा को कुछ हद तक बेहतर बनाया जाता है.

एलिवेशन एपीआई का अनुरोध इस तरह का होता है:

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

जहां outputFormat इनमें से कोई एक वैल्यू हो सकती है:

  • json (सुझाया गया), इस फ़ील्ड में आउटपुट दिखाता है JavaScript ऑब्जेक्ट नोटेशन (JSON); या
  • xml, एक्सएमएल में आउटपुट दिखाता है, जिसे <ElevationResponse> नोड.

ध्यान दें: यूआरएल सही तरीके से कोड में बदला गया मान्य होने चाहिए और सभी वेब सेवाओं के लिए इसकी सीमा 16384 वर्ण होनी चाहिए. अपने यूआरएल बनाते समय इस सीमा का ध्यान रखें. ध्यान दें कि अलग-अलग ब्राउज़र में, प्रॉक्सी, और सर्वर की URL वर्ण सीमाएं भी भिन्न हो सकती हैं.

एचटीटीपीएस, एपीआई पासकोड का इस्तेमाल करने वाले अनुरोधों के लिए ज़रूरी है.

अनुरोध के पैरामीटर

एलिवेशन एपीआई को किए गए अनुरोध अलग-अलग पैरामीटर का इस्तेमाल करते हैं इस पर आधारित होता है कि अनुरोध अलग-अलग जगहों के लिए है या ऑर्डर किया गया पाथ. अलग-अलग जगहों के लिए, ऊंचाई वापसी के अनुरोध अनुरोध में पास की गई खास जगहों का डेटा; पाथ, दिए गए पाथ के हिसाब से, ऊंचाई तय करने के अनुरोधों को सैंपल के तौर पर इस्तेमाल किया जाता है.

जैसा कि सभी यूआरएल में स्टैंडर्ड होता है, पैरामीटर अलग-अलग कर दिए जाते हैं एंपरसैंड (&amp;) वर्ण का इस्तेमाल करके. पैरामीटर की सूची और उनके संभावित वैल्यू की जानकारी नीचे दी गई है.

सभी अनुरोध

  • key — (ज़रूरी है) आपके ऐप्लिकेशन एपीआई पासकोड. यह कुंजी, कोटा मैनेजमेंट के लिए आपके ऐप्लिकेशन की पहचान करती है. कुंजी पाने का तरीका जानें.

पोज़िशन के लिए किए गए अनुरोध

  • locations (ज़रूरी है) वह पृथ्वी है जिससे ऊंचाई डेटा वापस करना है. इस पैरामीटर को किसी एक जगह की जानकारी, जिसमें कॉमा लगाकर अलग किए गए {latitude,longitude} जोड़े गए हों (उदाहरण के लिए, "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 पॉइंट या निर्देशांक ज़्यादा हैं या '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 के बीच का कोई भी मान. अगर आप तय करते हैं कि अमान्य अक्षांश या देशांतर मान, आपका अनुरोध अस्वीकार कर दिया जाएगा के रूप में भी इस्तेमाल किया जा सकता है.

आप किसी अरे या कोड में बदले गए 512 निर्देशांकों को पास कर सकते हैं पॉलीलाइन, वह अभी भी एक मान्य URL बना रहा है. ध्यान दें कि एकाधिक पास करते समय निर्देशांकों को नहीं दिखाया जाता, तो दिखाए गए किसी भी डेटा की सटीकता किसी एक कोऑर्डिनेट के लिए डेटा का अनुरोध करते समय 512 पॉइंट या निर्देशांक से ज़्यादा 'जगहों' में या 'path' पैरामीटर से INVALID_REQUEST रिस्पॉन्स मिलता है.

एलिवेशन रिस्पॉन्स

हर मान्य अनुरोध के लिए, एलिवेशन सेवा एक ऊंचाई बताएगी अनुरोध वाले यूआरएल में बताए गए फ़ॉर्मैट में जवाब देना होगा.

ElevationResponse

FieldRequiredTypeDescription
required Array<ElevationResult> See ElevationResult for more information.
requiredElevationStatus 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 के अलावा कोई दूसरा हो, तो एलिवेशन रिस्पॉन्स ऑब्जेक्ट में error_message फ़ील्ड. इस फ़ील्ड में ज़्यादा फ़ील्ड शामिल हैं दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी.

रिस्पॉन्स में इन एलिमेंट के साथ एक results कलेक्शन शामिल होता है:

ElevationResult

FieldRequiredTypeDescription
requirednumber

The elevation of the location in meters.

requiredLatLngLiteral

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
requirednumber

Latitude in decimal degrees

requirednumber

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",
}

XML

<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 फ़्लैग का इस्तेमाल करने के बारे में बताया गया है:

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'

इस अनुरोध में एक्सएमएल output फ़्लैग का इस्तेमाल करने के बारे में बताया गया है:

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

JSON और एक्सएमएल के सैंपल देखने के लिए, नीचे दिए गए टैब चुनें.

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",
}

XML

<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 माउंट व्हिटनी, CA से बैडवाटर, CA तक, सबसे ऊंची और महाद्वीपीय अमेरिका में सबसे कम बिंदु. हम तीन 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",
}

XML

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