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

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

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

• वाहन का शीर्षक और सड़क के किनारे की जानकारी देना
• बीच के वेपॉइंट तय करना
• किसी रास्ते के आस-पास का स्टॉप सेट करना
• किसी रास्ते से होकर गुज़रने के लिए एक पॉइंट सेट करना
• अपने रास्ते के स्टॉप के क्रम को ऑप्टिमाइज़ करना

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

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

• जगह का आईडी (पसंदीदा)
• अक्षांश/देशांतर निर्देशांक
• पता स्ट्रिंग ("शिकागो, इलिनॉय" या "डारविन, एनटी, ऑस्ट्रेलिया")
• प्लस कोड

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

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

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

स्थान आईडी के रूप में कोई स्थान बताएं

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

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

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

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

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

वेपॉइंट में जगह तय करने के लिए, अक्षांश/देशांतर निर्देशांक का इस्तेमाल करके जगह (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 एंफ़ीथिएटर पार्कवे, माउंटेन व्यू, CA" से दिखाया जाता है. जियोकोडिंग किसी पता स्ट्रिंग को अक्षांश और देशांतर निर्देशांक (जैसे कि अक्षांश 37.423021 और देशांतर -122.083739) में बदलने की प्रक्रिया है.

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

ध्यान दें: अक्षांश और देशांतर निर्देशांक, जियोकोडिंग एपीआई से दिखाए गए अक्षांश और देशांतर के निर्देशांकों से अलग हो सकते हैं. उदाहरण के लिए, 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 मिलते-जुलते पतों को अलग करने के लिए, खोज शुरू कर सकता है. उदाहरण के लिए, "पहली सड़क NE" या "पहली सड़क NE" के लिए "पहली सड़क" पूरी वैल्यू या आंशिक वैल्यू हो सकती है. यह नतीजा, जियोकोडिंग एपीआई के ज़रिए दिखाए गए नतीजे से अलग हो सकता है. प्लेस आईडी का इस्तेमाल करके, ऐसा हो सकता है कि कोई ऐसा शब्द जिसे गलत तरीके से समझा जा सके.

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

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

{
  "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, उन लोगों या जगहों के मोहल्ले के पते की तरह होते हैं जिनका कोई असली पता नहीं होता. Plus Code, सड़क के नाम और नंबर वाले पतों के बजाय, अक्षांश/देशांतर निर्देशांक पर आधारित होते हैं. इन्हें नंबर और अक्षरों के तौर पर दिखाया जाता है.

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

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" फ़ॉर्म में जोड़ें.

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

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

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