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

परिचय

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

• आस-पास की जगहों के लिए खोज करने की सुविधा (नई), एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी POST अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, आस-पास की जगहों को खोजने की सुविधा (लेगसी) में, एचटीटीपी GET अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
• फ़ील्ड मास्किंग ज़रूरी है. आपको यह बताना होगा कि आपको जवाब में कौनसे फ़ील्ड चाहिए. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. इस सूची को शामिल न करने पर, तरीकों से गड़बड़ी का मैसेज मिलता है. ज़्यादा जानकारी के लिए, FieldMask देखें.
• 'आस-पास खोजें' (नई सुविधा) में पुष्टि करने के तरीके के तौर पर, एपीआई पासकोड और OAuth टोकन, दोनों का इस्तेमाल किया जा सकता है.
• 'आस-पास खोजें' (नया वर्शन) में, जवाब के फ़ॉर्मैट के तौर पर सिर्फ़ JSON का इस्तेमाल किया जा सकता है.
• टेक्स्ट क्वेरी वाले सभी अनुरोधों के लिए, अब टेक्स्ट से खोजें (नई सुविधा) का इस्तेमाल करना चाहिए. ऐसा इसलिए, क्योंकि आस-पास खोजें (नई सुविधा) में टेक्स्ट डालने की सुविधा उपलब्ध नहीं है.
• Nearby Search (New) के लिए JSON रिस्पॉन्स फ़ॉर्मैट, लेगसी एपीआई के फ़ॉर्मैट से बदल गया है. ज़्यादा जानकारी के लिए, Places API के रिस्पॉन्स को माइग्रेट करना लेख पढ़ें.

यहां दी गई टेबल में, आस-पास की जगहों की जानकारी (लेगसी) के उन पैरामीटर की सूची दी गई है जिनके नाम बदल दिए गए हैं या जिनमें आस-पास की जगहों की जानकारी (नया वर्शन) के लिए बदलाव किया गया है. इसमें उन पैरामीटर की सूची भी दी गई है जो अब काम नहीं करते.

मौजूदा पैरामीटर	नया पैरामीटर	नोट
keyword		समर्थित नहीं. इसके बजाय, टेक्स्ट खोज (नया) का इस्तेमाल करें.
language	languageCode
location	locationRestriction	ज़रूरी है.
maxprice/minprice		समर्थित नहीं.
	maxResultCount	नया पैरामीटर.
opennow		समर्थित नहीं.
pagetoken		समर्थित नहीं.
radius		अब locationRestriction का इस्तेमाल करें.
rankby	rankPreference
	regionCode	नया पैरामीटर.
type	includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes	नए पैरामीटर, कई तरह की वैल्यू भी स्वीकार करते हैं. लेगसी एपीआई सिर्फ़ एक वैल्यू स्वीकार करता है.

अनुरोध का उदाहरण

यहां दिए गए GET अनुरोध के उदाहरण में, आस-पास की जगहों की खोज (लेगसी) का इस्तेमाल किया गया है. इस उदाहरण में, आपने 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