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