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

जवाब में दी गई हर जगह तक पहुंचने में लगने वाला समय और दूरी का हिसाब लगाने के लिए, Text Search (नई) या Nearby Search (नई) का इस्तेमाल करना:

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

2. फ़ील्ड मास्क में routingSummaries शामिल करें, ताकि जवाब में routingSummaries कलेक्शन शामिल हो. इस कलेक्शन में, रास्ते की शुरुआत की जगह से लेकर जवाब में दी गई हर जगह तक पहुंचने में लगने वाला समय और दूरी शामिल होती है.

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

Text Search (नई) का इस्तेमाल करना

यहां दिए गए अनुरोध में, Text Search (नई) के जवाब में दी गई हर जगह तक पहुंचने में लगने वाला समय और दूरी का हिसाब लगाया जाता है:

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 शामिल होता है.

{
  "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 मीटर है.

Nearby Search का इस्तेमाल करना

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

  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 पैरामीटर का इस्तेमाल करें. इन विकल्पों के बारे में ज़्यादा जानने के लिए, रास्तों के लिए उपलब्ध गाड़ी के टाइप लेख पढ़ें.

• रास्ते की प्राथमिकता का विकल्प TRAFFIC_UNAWARE (डिफ़ॉल्ट), TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL सेट करने के लिए, routingParameters.routingPreference प्रॉपर्टी का इस्तेमाल करें. हर विकल्प में, डेटा की क्वालिटी और इंतज़ार का समय अलग-अलग होता है. ज़्यादा जानकारी के लिए, ट्रैफ़िक का डेटा शामिल करने का तरीका और उससे जुड़ी शर्तें तय करना लेख पढ़ें.

  routingParameters.routingPreference प्रॉपर्टी, झलक (Pre-GA) 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. सबमिट करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

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