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