Places API, मौजूदा टेक्स्ट सर्च के साथ काम करता है. अगर आपको मौजूदा टेक्स्ट सर्च के बारे में पता है, तो टेक्स्ट सर्च के नए वर्शन में ये बदलाव किए गए हैं:
- नया टेक्स्ट सर्च, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करता है. एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, मौजूदा टेक्स्ट सर्च में, एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके, यूआरएल पैरामीटर पास किए जाते हैं.
- फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि आपको रिस्पॉन्स में कौनसे फ़ील्ड चाहिए. दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. अगर इस सूची को छोड़ा जाता है, तो मेथड गड़बड़ी का मैसेज दिखाते हैं. ज़्यादा जानकारी के लिए, FieldMask देखें.
- नई टेक्स्ट सर्च की सुविधा, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth टोकन, दोनों के साथ काम करती है.
- नए टेक्स्ट सर्च में, रिस्पॉन्स के तौर पर सिर्फ़ JSON फ़ॉर्मैट का इस्तेमाल किया जा सकता है.
मौजूदा टेक्स्ट सर्च की मदद से, क्वेरी स्ट्रिंग में अक्षांश और देशांतर के निर्देशांक डाले जा सकते हैं. उदाहरण के लिए:
query=37.4239,-122.0925. यह विकल्प, टेक्स्ट सर्च के नए वर्शन में काम नहीं करता.निर्देशांक खोजने और पता पाने के लिए, रिवर्स जियोकोडिंग का इस्तेमाल करें. इसके अलावा, किसी जगह के आस-पास की जगहें खोजने के लिए, आस-पास की जगहें खोजने की सुविधा (नई) का इस्तेमाल करें.
- टेक्स्ट सर्च (नया) एपीआई के लिए, JSON रिस्पॉन्स फ़ॉर्मैट को मौजूदा एपीआई के फ़ॉर्मैट से बदल दिया गया है. ज़्यादा जानकारी के लिए, Places API के रिस्पॉन्स को माइग्रेट करना लेख देखें.
इस टेबल में, मौजूदा टेक्स्ट सर्च में मौजूद उन पैरामीटर की सूची दी गई है जिनका नाम बदला गया है या जिनमें नई टेक्स्ट सर्च के लिए बदलाव किया गया है. इसके अलावा, इसमें ऐसे पैरामीटर भी शामिल हैं जो अब काम नहीं करते.
| मौजूदा पैरामीटर | नया पैरामीटर | नोट |
|---|---|---|
evOptions |
नया पैरामीटर. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
सभी अनुरोधों में ज़रूरी है. |
radius |
locationBias |
locationBias तय करते समय, त्रिज्या की जानकारी दें. |
region |
regionCode |
|
type |
includedType |
इसमें सिर्फ़ एक वैल्यू डाली जा सकती है. |
strictTypeFiltering |
नया पैरामीटर. |
अनुरोध का उदाहरण
नीचे दिए गए उदाहरण में, जीईटी अनुरोध में मौजूदा टेक्स्ट सर्च का इस्तेमाल किया गया है. इस उदाहरण में, "ऑस्ट्रेलिया के सिडनी में स्पाइसी वेजीटेरियन फ़ूड" के बारे में जानकारी देने वाले JSON रिस्पॉन्स का अनुरोध किया गया है. साथ ही, सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर पास किया गया है:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
टेक्स्ट सर्च (नया) की मदद से, पीओएसटी अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या हेडर में, पीओएसटी अनुरोध के हिस्से के तौर पर पास किया जाता है. इस उदाहरण में भी फ़ील्ड मास्क का इस्तेमाल किया गया है, ताकि जवाब में सिर्फ़ जगह का डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल हो:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'