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