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'

आस-पास की जगहों की जानकारी (नया) की मदद से, पोस्ट अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को 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