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