परिचय
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
टेक्स्ट से खोजें (नई सुविधा) में, POST अनुरोध किया जाता है. साथ ही, सभी पैरामीटर को 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'