Places API, मौजूदा Text Search के साथ काम करता है. अगर आपको मौजूदा Text Search के बारे में जानकारी है, तो Text Search के नए वर्शन में ये बदलाव किए जाएंगे:
- नई Text Search, एचटीटीपी पोस्ट अनुरोधों का इस्तेमाल करती है. एचटीटीपी पोस्ट अनुरोध के हिस्से के तौर पर, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. इसके उलट, मौजूदा टेक्स्ट सर्च के लिए, एचटीटीपी जीईटी अनुरोध का इस्तेमाल करके यूआरएल पैरामीटर पास किए जाते हैं.
- फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि रिस्पॉन्स में कौनसे फ़ील्ड दिखाए जाएं. लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. अगर इस सूची को छोड़ दिया जाता है, तो तरीके एक गड़बड़ी दिखाते हैं. ज़्यादा जानकारी के लिए, FieldMask देखें.
- टेक्स्ट खोजने की नई सुविधा, पुष्टि करने के तरीके के तौर पर एपीआई पासकोड और OAuth, दोनों टोकन के साथ काम करती है.
- नए Text Search में, रिस्पॉन्स फ़ॉर्मैट के तौर पर सिर्फ़ JSON काम करता है.
मौजूदा Text Search से आपको क्वेरी स्ट्रिंग में अक्षांश और देशांतर निर्देशांक तय करने की सुविधा मिलती है. उदाहरण के लिए:
query=37.4239,-122.0925. यह विकल्प नए Text Search में काम नहीं करता.निर्देशांकों पर खोजने और पता दिखाने के लिए रिवर्स जियोकोडिंग का इस्तेमाल करें या किसी जगह के आस-पास की जगहें खोजने के लिए आस-पास खोज (नई सुविधा) का इस्तेमाल करें.
- Text Search (New) एपीआई के JSON रिस्पॉन्स फ़ॉर्मैट को मौजूदा एपीआई के फ़ॉर्मैट से बदल दिया गया है. ज़्यादा जानकारी के लिए, Places API रिस्पॉन्स को माइग्रेट करना देखें.
नीचे दी गई टेबल में, मौजूदा Text Search के वे पैरामीटर दिए गए हैं जिनका नाम बदला गया है या जिनमें नए Text Search के लिए बदलाव किया गया है. इसके अलावा, ऐसे पैरामीटर की जानकारी भी दी गई है जो अब काम नहीं करते.
| मौजूदा पैरामीटर | नया पैरामीटर | ज़रूरी जानकारी |
|---|---|---|
evOptions |
नया पैरामीटर. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
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 अनुरोध के मुख्य हिस्से या हेडर में POST अनुरोध के हिस्से के तौर पर पास किया जाता है. इस उदाहरण में फ़ील्ड मास्क का भी इस्तेमाल किया गया है, इसलिए जवाब में जगह का सिर्फ़ डिसप्ले नेम और फ़ॉर्मैट किया गया पता शामिल है:
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'