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

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

• आस-पास की जगहों की नई खोज सुविधा, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर, अनुरोध बॉडी या हेडर में पैरामीटर पास करें. इसके उलट, आस-पास के कारोबारों को खोजने की मौजूदा सुविधा में, एचटीटीपी GET अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
• फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि आपको जवाब में कौनसे फ़ील्ड चाहिए. दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. अगर इस सूची को छोड़ा जाता है, तो ये तरीके गड़बड़ी का मैसेज दिखाते हैं. ज़्यादा जानकारी के लिए, 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'

आस-पास के कारोबारों को खोजने की सुविधा (नया वर्शन) में, आपको एक POST अनुरोध करना होता है. साथ ही, POST अनुरोध के हिस्से के तौर पर, 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