Nearby Search पर माइग्रेट करना (नया)

परिचय

Places API, आस-पास की जगहें ढूंढने की सुविधा (लेगसी) के साथ काम करता है. अगर आपने Nearby Search (लेगसी) का इस्तेमाल किया है, तो Nearby Search (नया) में ये बदलाव किए गए हैं:

• आस-पास की जगहों के लिए खोज करने की नई सुविधा, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी POST अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, आस-पास की जगहों को खोजने की सुविधा (लेगसी) में, एचटीटीपी GET अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
• फ़ील्ड मास्किंग ज़रूरी है. आपको यह बताना होगा कि रिस्पॉन्स में आपको कौनसे फ़ील्ड चाहिए. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. इस सूची को शामिल न करने पर, ये तरीके गड़बड़ी दिखाते हैं. ज़्यादा जानकारी के लिए, FieldMask देखें.
• Nearby Search (नया) में पुष्टि करने के तरीके के तौर पर, एपीआई पासकोड और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.
• 'आस-पास खोजें (नया वर्शन)' में, जवाब के फ़ॉर्मैट के तौर पर सिर्फ़ JSON का इस्तेमाल किया जा सकता है.
• टेक्स्ट क्वेरी वाले सभी अनुरोधों के लिए, अब टेक्स्ट से खोज करने की सुविधा (नई) का इस्तेमाल करना चाहिए. ऐसा इसलिए, क्योंकि आस-पास खोजने की सुविधा (नई) में टेक्स्ट डालने की सुविधा काम नहीं करती.
• Nearby Search (New) के लिए JSON रिस्पॉन्स फ़ॉर्मैट, लेगसी एपीआई के फ़ॉर्मैट से बदल गया है. ज़्यादा जानकारी के लिए, Places API के रिस्पॉन्स को माइग्रेट करना लेख पढ़ें.

यहां दी गई टेबल में, आस-पास की जगहों की खोज (लेगसी) के उन पैरामीटर की सूची दी गई है जिनके नाम बदलकर आस-पास की जगहों की खोज (नया वर्शन) के लिए इस्तेमाल किए जा रहे हैं या जिनमें बदलाव किया गया है. इसके अलावा, ऐसे पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.

मौजूदा पैरामीटर	नया पैरामीटर	नोट
keyword		समर्थित नहीं. इसके बजाय, टेक्स्ट खोज (नया) का इस्तेमाल करें.
language	languageCode
location	locationRestriction	ज़रूरी है.
maxprice/minprice		समर्थित नहीं.
	maxResultCount	नया पैरामीटर.
opennow		समर्थित नहीं.
pagetoken		समर्थित नहीं.
radius		अब locationRestriction का इस्तेमाल करें.
rankby	rankPreference
	regionCode	नया पैरामीटर.
type	includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes	नए पैरामीटर, कई तरह की वैल्यू भी स्वीकार करते हैं. लेगसी एपीआई सिर्फ़ एक वैल्यू स्वीकार करता है.

अनुरोध का उदाहरण

नीचे दिए गए उदाहरण में, GET अनुरोध के लिए Nearby Search (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने restaurant टाइप की जगहों के बारे में जानकारी देने वाले JSON रिस्पॉन्स का अनुरोध किया है. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया है:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

Nearby Search (नया) की मदद से, POST अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या POST अनुरोध के हिस्से के तौर पर हेडर में पास किया जाता है. इस उदाहरण में फ़ील्ड मास्क का भी इस्तेमाल किया गया है, ताकि जवाब में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल हो:

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