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

जवाब में मौजूद हर जगह की यात्रा में लगने वाले समय और दूरी का हिसाब लगाने के लिए, टेक्स्ट से खोजें (नया) या आस-पास की जगहों की जानकारी (नया) का इस्तेमाल करें:

1. अनुरोध में routingParameters.origin पैरामीटर पास करें, ताकि रूटिंग की शुरुआत की जगह के अक्षांश और देशांतर के निर्देशांकों की जानकारी दी जा सके. जवाब में हर जगह की दूरी और वहां पहुंचने में लगने वाले समय का हिसाब लगाने के लिए, यह पैरामीटर ज़रूरी है.

2. फ़ील्ड मास्क में routingSummaries को शामिल करें, ताकि जवाब में routingSummaries कलेक्शन शामिल हो. इस कलेक्शन में, रूटिंग के ऑरिजिन से लेकर रिस्पॉन्स में मौजूद हर जगह तक की अवधि और दूरी की जानकारी होती है.

   ध्यान दें: फ़ील्ड मास्क में routingSummaries जोड़ने के लिए, अनुरोध में routingParameters.origin पैरामीटर या searchAlongRouteParameters.polyline.encodedPolyline पैरामीटर को शामिल करना ज़रूरी है. ऐसा न करने पर गड़बड़ी होती है.

APIs Explorer की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और उसके विकल्पों के बारे में जानकारी मिलती है:

इसे आज़माएं!

टेक्स्ट से खोजें (नया) सुविधा का इस्तेमाल करना

यहां दिए गए अनुरोध में, टेक्स्ट से खोजें (नया वर्शन) के रिस्पॉन्स में मौजूद हर जगह तक पहुंचने में लगने वाले समय और दूरी का हिसाब लगाया जाता है:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

रिस्पॉन्स में दो JSON कलेक्शन होते हैं: places कलेक्शन में, मैच होने वाली जगहें होती हैं. वहीं, routingSummaries कलेक्शन में, हर जगह तक पहुंचने में लगने वाला समय और दूरी की जानकारी होती है:

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

routingSummaries कलेक्शन का हर एलिमेंट, places कलेक्शन में मौजूद जगह के हिसाब से, उससे जुड़े कलेक्शन की जगह पर होता है. इसका मतलब है कि routingSummaries[0] पर मौजूद एलिमेंट, places[0] पर मौजूद जगह से मेल खाता है.

routingSummaries की अरे लेंथ, places की अरे लेंथ के बराबर है. अगर किसी जगह के लिए routingSummary उपलब्ध नहीं है, तो अरे एंट्री खाली होती है.

इस उदाहरण में, रूटिंग की शुरुआत की जगह से हर जगह तक की दूरी और समय का हिसाब लगाया गया है. इसलिए, रिस्पॉन्स में routingSummaries.legs फ़ील्ड में एक Leg ऑब्जेक्ट होता है. इसमें रूटिंग की शुरुआत की जगह से लेकर उस जगह तक की duration और distanceMeters की जानकारी होती है.

ध्यान दें: इस रिस्पॉन्स में, हर जगह की जानकारी देने वाली रूटिंग की खास जानकारी में, झलक (pre-GA) directionsUri फ़ील्ड भी शामिल होता है. इस फ़ील्ड में एक लिंक होता है. इस पर क्लिक करके, Google Maps में उस जगह का रास्ता देखा जा सकता है. routingParameters.origin पैरामीटर का इस्तेमाल, दिशा-निर्देशों के ऑरिजिन के तौर पर किया जाता है. साथ ही, जगह की जानकारी का इस्तेमाल डेस्टिनेशन के तौर पर किया जाता है. इसके अलावा, यात्रा का मोड डिफ़ॉल्ट रूप से ड्राइव पर सेट होता है.

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

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

इस उदाहरण से पता चलता है कि रूटिंग के ऑरिजिन से नतीजों में मौजूद पहली जगह तक पहुंचने में 597 सेकंड लगते हैं और इसकी दूरी 2, 607 मीटर है.

आस-पास की जगहों की जानकारी का इस्तेमाल करना

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

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

आपको locationRestriction और रूटिंग ऑरिजिन के लिए, एक ही निर्देशांक इस्तेमाल करने की ज़रूरत नहीं है. उदाहरण के लिए, आपने locationRestriction को सिडनी के सेंटर पॉइंट पर सेट किया, ताकि खोज के नतीजे उस सर्कल के हिसाब से दिखाए जा सकें. हालांकि, इसके बाद आपने रूटिंग के ऑरिजिन को अपने घर के निर्देशांकों पर सेट किया. इसका मतलब है कि आपने खोज के दायरे में मौजूद किसी दूसरी जगह को सेट किया. इसके बाद, अनुरोध के आधार पर खोज के नतीजे, सर्कल के हिसाब से दिखाए जाते हैं. साथ ही, आपके घर की जगह की जानकारी के आधार पर, रास्ते की खास जानकारी का हिसाब लगाया जाता है.

यात्रा के विकल्प तय करना

डिफ़ॉल्ट रूप से, यात्रा में लगने वाले समय और दूरी का हिसाब कार के हिसाब से लगाया जाता है. हालांकि, खोज के नतीजों में दिखने वाले वाहन के टाइप और अन्य विकल्पों को कंट्रोल किया जा सकता है.

• यात्रा के मोड को DRIVE, BICYCLE, WALK या TWO_WHEELER पर सेट करने के लिए, routingParameters.travelMode पैरामीटर का इस्तेमाल करें. इन विकल्पों के बारे में ज़्यादा जानकारी के लिए, रास्तों के लिए उपलब्ध वाहन के टाइप देखें.

  ध्यान दें: Routes API, TRANSIT मोड के साथ भी काम करता है. हालांकि, Places API (नया) इस मोड के साथ काम नहीं करता.
  ध्यान दें: TWO_WHEELER विकल्प सिर्फ़ उन देशों में काम करता है जो दोपहिया वाहनों के लिए उपलब्ध देशों और इलाकों की सूची में शामिल हैं.
• routingParameters.routingPreference प्रॉपर्टी का इस्तेमाल करके, रूटिंग की प्राथमिकता के विकल्प को TRAFFIC_UNAWARE (डिफ़ॉल्ट), TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट करें. हर विकल्प में, डेटा क्वालिटी और इंतज़ार का समय अलग-अलग होता है. ज़्यादा जानकारी के लिए, ट्रैफ़िक डेटा को शामिल करने का तरीका और उसे शामिल करना है या नहीं, यह तय करना लेख पढ़ें.

  routingParameters.routingPreference प्रॉपर्टी, झलक (प्री-जीए) directionsUri फ़ील्ड में मौजूद निर्देशों पर असर डालती है. ऐसा इसलिए होता है, क्योंकि लिंक खोलने पर Google Maps, ट्रैफ़िक के विकल्प दिखाता है.

• routingParameters.routeModifiers प्रॉपर्टी का इस्तेमाल करके, avoidTolls, avoidHighways, avoidFerries, और avoidIndoor के बारे में बताएं. इन विकल्पों के बारे में ज़्यादा जानकारी के लिए, रास्ते की उन सुविधाओं के बारे में बताएं जिनसे बचना है लेख पढ़ें.

अगले उदाहरण में, यात्रा के मोड को DRIVE के तौर पर सेट किया गया है और हाइवे से बचने के लिए कहा गया है:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

इसे आज़माएं!

APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और उसके विकल्पों के बारे में जानकारी मिलती है.

1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.

2. अनुरोध के पैरामीटर में बदलाव करें. हालांकि, ऐसा करना ज़रूरी नहीं है.

3. Execute बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें. इससे APIs Explorer विंडो बड़ी हो जाएगी.