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

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

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 8 जुलाई 2025 से, सेवाओं के आपके इस्तेमाल पर Google Maps Platform की ईईए से जुड़ी सेवा की शर्तें लागू होंगी. यह सुविधा, देश/इलाके के हिसाब से अलग-अलग हो सकती है. ज़्यादा जानें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  []
}

एपीआई को किसी खास इलाके के हिसाब से नतीजे दिखाने के लिए कॉन्फ़िगर किया जा सकता है. इसके लिए, regionCode पैरामीटर शामिल करें. यह पैरामीटर, क्षेत्र के कोड को दो वर्णों वाली सीसीटीएलडी ("टॉप-लेवल डोमेन") वैल्यू के तौर पर दिखाता है. ज़्यादातर 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",
      ...
    }
  ]
}

किसी जगह को नेविगेशन पॉइंट टोकन के तौर पर तय करना

यह प्रॉडक्ट या सुविधा, फ़िलहाल सिर्फ़ झलक के तौर पर उपलब्ध है (pre-GA). हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं के लिए, आपको पूरी सहायता न मिले. साथ ही, ऐसा हो सकता है कि Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं में किए गए बदलाव, Pre-GA के अन्य वर्शन के साथ काम न करें. Pre-GA ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

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

Geocoding API के Destinations तरीके को कॉल करके, नेविगेशन पॉइंट टोकन पाया जा सकता है.

नेविगेशन पॉइंट टोकन तय करने के लिए:

1. Geocoding API के SearchDestinations तरीके से navigationPointToken पाएं. ज़्यादा जानकारी के लिए, Geocoding API से जुड़ा दस्तावेज़ देखें.
2. navigationPointToken पास करके, एक वेपॉइंट बनाएं.

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

{
  "origin":{
    "navigation_point_token": "ENCODED_NAVIGATION_POINT_TOKEN_FOR_ORIGIN"
  },
  "destination":{
    "navigation_point_token": "ENCODED_NAVIGATION_POINT_TOKEN_FOR_DESTINATION"
  },
  ...
}

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

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

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

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

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 स्टैनफ़र्ड, कैलिफ़ोर्निया 94305, अमेरिका".

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

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

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