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

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

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

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

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

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

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

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

जगह के आईडी के तौर पर जगह की जानकारी दें

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

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

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

{
  "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 से मिले नतीजे से अलग हो सकता है. जगह के आईडी का इस्तेमाल करके, डेटा को गलत तरीके से समझने से बचा जा सकता है.

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

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

{
  "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वां हिस्सा) को 1/8,000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा दिखाता है. सड़क के पतों की जगह Plus Code का इस्तेमाल किया जा सकता है. ऐसा उन जगहों पर किया जा सकता है जहां कोई पता नहीं है या जहां इमारतों को नंबर नहीं दिया गया है या सड़कों के नाम नहीं दिए गए हैं.

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

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

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

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

    उदाहरण के लिए, "450 Serra मॉल, 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 एपीआई में काम करते हैं. इनमें जगह के बारे में ऑटोकंप्लीट की सुविधा, जगह की जानकारी, दिशा-निर्देश एपीआई, और जियोकोडिंग एपीआई शामिल हैं. उदाहरण के लिए, जगह का Plus Code पता करने के लिए अक्षांश/देशांतर निर्देशांक के हिसाब से तय की गई जगह की जियोकोडिंग के लिए Geocoding API का इस्तेमाल किया जा सकता है.