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

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

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

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

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

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

यहां दिए गए जीईटी अनुरोध के उदाहरण में, आस-पास की जगहों की खोज (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, 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'

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

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