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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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