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

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

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

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

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

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

जीईटी अनुरोध के इस उदाहरण में, मौजूदा आस-पास खोज की सुविधा का इस्तेमाल किया गया है. इस उदाहरण में, आपने JSON रिस्पॉन्स का अनुरोध किया है, जिसमें restaurant टाइप की जगहों के बारे में जानकारी शामिल है. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया जाता है:

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'

Nearby Search (नया) का इस्तेमाल करके, पोस्ट करने का अनुरोध किया जा सकता है और 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