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

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

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