किसी रास्ते के लिए जगहें बताना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

रास्ते का हिसाब लगाने के लिए, आपको कम से कम रास्ते की शुरुआती जगह और मंज़िल की जानकारी देनी होगी. इन जगहों को रास्ते में वेपॉइंट के तौर पर तय किया जाता है.

शुरुआत और मंज़िल के अलावा, अलग-अलग तरह के वेपॉइंट तय किए जा सकते हैं. साथ ही, यह भी तय किया जा सकता है कि किसी रास्ते के लिए वेपॉइंट को कैसे हैंडल किया जाए. ज़्यादा जानकारी और उदाहरणों के लिए, ये विषय देखें:

किसी रूट के लिए जगहों की जानकारी देना

किसी जगह को दिखाने के लिए, वेपॉइंट (REST) या वेपॉइंट (gRPC) ऑब्जेक्ट बनाएं. वेपॉइंट की परिभाषा में, किसी जगह की जानकारी इनमें से किसी भी तरीके से दी जा सकती है:

किसी अनुरोध में सभी वेपॉइंट के लिए, एक ही तरीके से जगहें तय की जा सकती हैं. इसके अलावा, उन्हें मिक्स भी किया जा सकता है. उदाहरण के लिए, ओरिजन वेपॉइंट के लिए अक्षांश/देशांतर निर्देशांक और डेस्टिनेशन वेपॉइंट के लिए जगह के आईडी का इस्तेमाल किया जा सकता है.

बेहतर परफ़ॉर्मेंस और सटीक नतीजों के लिए, अक्षांश/देशांतर के निर्देशांक या पते की स्ट्रिंग के बजाय जगह के आईडी का इस्तेमाल करें. जगह के आईडी, खास तौर पर यूनीक होते हैं. साथ ही, ये राउटिंग के लिए जियोकोडिंग के फ़ायदे देते हैं. जैसे, ऐक्सेस पॉइंट और ट्रैफ़िक वैरिएबल. इनसे, लोकेशन की जानकारी देने के अन्य तरीकों से होने वाली इन समस्याओं से बचा जा सकता है:

  • अक्षांश/देशांतर निर्देशांकों का इस्तेमाल करने से, जगह की जानकारी उन निर्देशांकों के सबसे नज़दीकी सड़क पर दिख सकती है. ऐसा हो सकता है कि वह सड़क, प्रॉपर्टी तक पहुंचने का ऐक्सेस पॉइंट न हो या वह सड़क, मंज़िल तक जल्दी या सुरक्षित तरीके से न पहुंचती हो.
  • रास्ते का हिसाब लगाने से पहले, पते की स्ट्रिंग को Routes API से जियोकोड करना ज़रूरी है, ताकि उन्हें अक्षांश/देशांतर के निर्देशांकों में बदला जा सके. इस कन्वर्ज़न से परफ़ॉर्मेंस पर असर पड़ सकता है.

किसी जगह को जगह के आईडी के तौर पर सेट करना

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

Geocoding API और Places API (इसमें Place Autocomplete भी शामिल है) से जगह के आईडी वापस पाएं. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.

इस उदाहरण में, placeId प्रॉपर्टी का इस्तेमाल करके origin और destination, दोनों के लिए जगह का आईडी पास किया गया है:

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

किसी जगह की जानकारी अक्षांश और देशांतर के निर्देशांक के तौर पर देना

किसी वेपॉइंट में जगह की जानकारी देने के लिए, अक्षांश/देशांतर निर्देशांक का इस्तेमाल करके Location (REST) या Location(gRPC) तय करें.

उदाहरण के लिए, latitude और longitude निर्देशांकों का इस्तेमाल करके, रूट origin और destination के लिए वेपॉइंट तय करें:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

किसी जगह को पते की स्ट्रिंग के तौर पर तय करना

पते की स्ट्रिंग, पते को दिखाने वाली स्ट्रिंग होती है. जैसे, "1600 Amphitheatre Parkway, Mountain View, CA". जियोकोडिंग, पते की स्ट्रिंग को अक्षांश और देशांतर के निर्देशांकों में बदलने की प्रोसेस है. जैसे, अक्षांश 37.423021 और देशांतर -122.083739.

जब किसी पते की स्ट्रिंग को वेपॉइंट की जगह के तौर पर पास किया जाता है, तो Routes API उस स्ट्रिंग को अक्षांश और देशांतर के निर्देशांकों में बदलने के लिए, अंदरूनी तौर पर जियोकोड करता है.

उदाहरण के लिए, किसी रास्ते का हिसाब लगाने के लिए, पते के स्ट्रिंग का इस्तेमाल करके, रास्ते origin और destination के लिए वेपॉइंट तय करें:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

इस उदाहरण में, Routes API दोनों पतों को अक्षांश और देशांतर निर्देशांकों में बदलने के लिए, जियोकोड करता है.

अगर पते की वैल्यू अस्पष्ट है, तो Routes API मिलते-जुलते पतों से अलग करने के लिए, खोज शुरू कर सकता है. उदाहरण के लिए, "1st Street" वैल्यू, "1st street NE" या "1st St SE" के लिए पूरी या आंशिक वैल्यू हो सकती है. यह नतीजा, Geocoding API से मिले नतीजे से अलग हो सकता है. जगह के आईडी का इस्तेमाल करके, गलतफ़हमी से बचा जा सकता है.

पते के लिए क्षेत्र सेट करना

अगर आपने किसी वेपॉइंट की जगह के तौर पर, पते की अधूरी स्ट्रिंग पास की है, तो हो सकता है कि API, गलत अक्षांश/देशांतर निर्देशांक का इस्तेमाल करे. उदाहरण के लिए, ड्राइविंग के रूट के लिए, ऑरिजिन के तौर पर "टॉलेडो" और डेस्टिनेशन के तौर पर "मैड्रिड" सेट करके अनुरोध किया जाता है:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

इस उदाहरण में, "टॉलेडो" को स्पेन में मौजूद शहर के बजाय, अमेरिका के ओहियो राज्य में मौजूद शहर के तौर पर समझा गया है. इसलिए, अनुरोध में एक खाली कलेक्शन दिखता है. इसका मतलब है कि कोई भी रूट मौजूद नहीं है:

{
  []
}

regionCode पैरामीटर शामिल करके, एपीआई को किसी खास इलाके के हिसाब से नतीजे दिखाने के लिए कॉन्फ़िगर किया जा सकता है. यह पैरामीटर, क्षेत्र के कोड को दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू के तौर पर दिखाता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड के यूनाइटेड किंगडम" के लिए है.

"टोलेडो" से "मैड्रिड" के लिए रास्ते की जानकारी के अनुरोध में regionCode पैरामीटर शामिल करने पर सही नतीजे मिलते हैं. ऐसा इसलिए, क्योंकि "टोलेडो" को स्पेन के एक शहर के तौर पर समझा जाता है:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

जवाब में अब स्पेन के टोलेडो से स्पेन के मैड्रिड तक का रास्ता शामिल है:

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

किसी जगह की जानकारी को Plus Code के तौर पर सेट करना

कई लोगों के पास सटीक पता नहीं होता. इस वजह से, उन्हें डिलीवरी पाने में मुश्किल हो सकती है. इसके अलावा, पते की जानकारी देने वाले लोग, डिलीवरी को ज़्यादा सटीक जगहों पर स्वीकार करना पसंद कर सकते हैं. जैसे, पीछे का दरवाज़ा या लोडिंग डॉक.

प्लस कोड, उन लोगों या जगहों के लिए मोहल्ले के पते की तरह होते हैं जिनके पास कोई पता नहीं होता. सड़क के नाम और नंबर वाले पतों के बजाय, Plus Code अक्षांश/देशांतर निर्देशांकों पर आधारित होते हैं. इन्हें संख्याओं और अक्षरों के तौर पर दिखाया जाता है.

Google ने Plus Code डेवलप किए हैं, ताकि हर व्यक्ति और हर जगह को पते का फ़ायदा मिल सके. प्लस कोड, एन्कोड किया गया जगह का रेफ़रंस होता है. यह अक्षांश/देशांतर के कोऑर्डिनेट से मिलता है. यह किसी इलाके को दिखाता है: 1/8000 डिग्री गुणा 1/8000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. Plus Codes का इस्तेमाल, उन जगहों पर मोहल्ले के पतों की जगह किया जा सकता है जहां वे मौजूद नहीं हैं या जहां इमारतों के नंबर नहीं हैं या सड़कों के नाम नहीं हैं.

Plus Code को ग्लोबल कोड या कंपाउंड कोड के तौर पर फ़ॉर्मैट किया जाना चाहिए:

  • ग्लोबल कोड में चार वर्णों का एरिया कोड और छह या इससे ज़्यादा वर्णों का लोकल कोड होता है.

    उदाहरण के लिए, "1600 Amphitheatre Parkway, Mountain View, CA" पते के लिए, ग्लोबल कोड "849V" है और लोकल कोड "CWC8+R9" है. इसके बाद, जगह की वैल्यू के तौर पर "849VCWC8+R9" बताने के लिए, पूरे 10 वर्णों वाले Plus Code का इस्तेमाल करें.

  • कंपाउंड कोड में छह या इससे ज़्यादा वर्णों वाला लोकल कोड होता है. इसमें जगह की जानकारी भी शामिल होती है.

    उदाहरण के लिए, "450 Serra Mall, Stanford, CA 94305, USA" का स्थानीय कोड "CRHJ+C3" है. अगर पता लंबा है, तो पते के स्थानीय कोड को शहर, राज्य, पिन कोड, और देश के हिस्से के साथ जोड़ें. जैसे, "CRHJ+C3 Stanford, CA 94305, USA".

    उदाहरण के लिए, प्लस कोड का इस्तेमाल करके, रास्ते के लिए वेपॉइंट origin और destination तय करके रास्ते का हिसाब लगाएं:

    {
  "origin":{
    "address": "849VCWC8+R9"
  },
  "destination":{
    "address": "CRHJ+C3 Stanford, CA 94305, USA"
  },
  "travelMode": "DRIVE"
}

प्लस कोड, Google Maps Platform API के साथ काम करते हैं. इनमें ये शामिल हैं: जगह के नाम अपने-आप पूरे होने की सुविधा, जगह की जानकारी, Directions API (लेगसी), और Geocoding API. उदाहरण के लिए, अक्षांश/देशांतर के निर्देशांकों से तय की गई किसी जगह को रिवर्स जियोकोड करने के लिए, Geocoding API का इस्तेमाल किया जा सकता है. इससे उस जगह का Plus Code पता लगाया जा सकता है.