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

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

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

नीचे दी गई टेबल में, मौजूदा 'आस-पास खोज' के उन पैरामीटर की सूची दी गई है जिनका नाम बदला गया है या जिनमें 'आस-पास खोज' की नई सुविधा के लिए बदलाव किया गया है. इसके अलावा, ऐसे पैरामीटर की सूची दी गई है जो अब काम नहीं करते.

मौजूदा पैरामीटर	नया पैरामीटर	ज़रूरी जानकारी
keyword		मौजूद नहीं. इसके बजाय, Text Search (नया) का इस्तेमाल करें.
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'

आस-पास खोज (नई सुविधा) का इस्तेमाल करने पर, 'पोस्ट करें' अनुरोध किया जाता है और सभी पैरामीटर 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