टेक्स्ट खोज (नया) किसी स्ट्रिंग के आधार पर स्थानों के सेट के बारे में जानकारी देता है — उदाहरण के लिए "दिल्ली में पिज़्ज़ा" या "ओटावा के आस-पास जूतों की दुकान" या "123 मेन स्ट्रीट". कॉन्टेंट बनाने सेवा, टेक्स्ट स्ट्रिंग और किसी भी जगह से मेल खाने वाली जगहों की सूची के साथ जवाब देती है सेट किया गया पूर्वाग्रह.
यह सेवा खास तौर पर, पते से जुड़ी ऐसी क्वेरी और स्ट्रिंग के बिना पते वाले कॉम्पोनेंट मेल खा सकते हैं, तो पते भी शामिल होते हैं. पते से जुड़ी ऐसी क्वेरी के उदाहरण जिनमें साफ़ तौर पर जानकारी नहीं दी गई है खराब तरीके से फ़ॉर्मैट किए गए पते या वे अनुरोध जिनमें बिना पते वाले कॉम्पोनेंट शामिल हों, जैसे कि अपने कारोबार के नाम के तौर पर. नीचे दी गई टेबल में दिए गए पहले दो उदाहरणों जैसे अनुरोध कोई स्थान न होने पर — जैसे क्षेत्र, स्थान, शून्य परिणाम दे सकता है प्रतिबंध, या स्थान पूर्वाग्रह — सेट है.
"10 हाई स्ट्रीट, यूनाइटेड किंगडम" या "123 Main Street, US" | यूके के कई "हाई स्ट्रीट"; यूएस में कई "मुख्य सड़क". क्वेरी से मनमुताबिक नतीजे तब तक नहीं मिलते, जब तक कि जगह की जानकारी की पाबंदी नहीं होती सेट. |
"चेन रेस्टोरेंट न्यूयॉर्क" | कई "चेन रेस्टोरेंट" दिल्ली में जगहें; मोहल्ले का पता नहीं है या यहां तक कि सड़क का नाम भी. |
"10 हाई स्ट्रीट, एशर यूके" या "123 मेन स्ट्रीट, प्लेसेंटन यूएस" | सिर्फ़ एक "हाई स्ट्रीट" यूके के शहर ईशर में; केवल एक "मुख्य सड़क" एक अमेरिकी शहर प्लेसेंटन सीए (कैलिफ़ोर्निया के लिए) में. |
"यूनिक रेस्टोरेंट का नाम न्यूयॉर्क" | न्यूयॉर्क में इस नाम का सिर्फ़ एक होटल; मोहल्ले का पता नहीं है जिन्हें पहचान करने की ज़रूरत होती है. |
"दिल्ली में पिज़्ज़ा रेस्टोरेंट" | इस क्वेरी में, जगह की जानकारी से जुड़ी पाबंदी और "पिज़्ज़ा रेस्टोरेंट" जैसी क्वेरी शामिल हैं इससे मेल खाता है आपके पास जगह की सटीक जानकारी होनी चाहिए. यह कई नतीजे दिखाता है. |
"+1 514-670-8700" | इस क्वेरी में फ़ोन नंबर शामिल है. यह उस फ़ोन नंबर से जुड़ी जगहें हैं. |
एपीआई एक्सप्लोरर की मदद से लाइव अनुरोध किए जा सकते हैं, ताकि आप एपीआई और एपीआई विकल्प:
टेक्स्ट से खोज के अनुरोध
टेक्स्ट खोज अनुरोध, इस फ़ॉर्म का एक एचटीटीपी पोस्ट अनुरोध होता है:
https://places.googleapis.com/v1/places:searchText
सभी पैरामीटर को 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,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
टेक्स्ट से खोजें (नए) जवाब
टेक्स्ट खोज (नया) रिस्पॉन्स के तौर पर JSON ऑब्जेक्ट. जवाब में:
places
कलेक्शन में, मिलती-जुलती सभी जगहें शामिल हैं.- कलेक्शन में मौजूद हर जगह को
Place
ऑब्जेक्ट है.Place
ऑब्जेक्ट में किसी एक के बारे में पूरी जानकारी है जगह. - अनुरोध में पास किया गया FieldMask
Place
ऑब्जेक्ट में दिए गए फ़ील्ड की सूची.
JSON ऑब्जेक्ट, इस फ़ॉर्मैट में है:
{ "places": [ { object (Place) } ] }
ज़रूरी पैरामीटर
-
FieldMask
जवाब में लौटाए जाने वाले फ़ील्ड की सूची बनाने के लिए, रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करना होगा. यूआरएल पैरामीटर का इस्तेमाल करके, तरीके के लिए रिस्पॉन्स फ़ील्ड मास्क पास करें
$fields
याfields
या एचटीटीपी हेडर का इस्तेमाल करकेX-Goog-FieldMask
. जवाब में दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. अगर फ़ील्ड मास्क को छोड़ दिया जाता है, तो यह तरीका गड़बड़ी दिखाता है.फ़ील्ड मास्किंग, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जाता है कि आप अनुरोध न करें डेटा की ज़रूरत नहीं होती, जिससे प्रोसेसिंग में लगने वाले ज़्यादा समय को कम करने और शुल्क नहीं लिया जाएगा.
दिखाए जाने वाले स्थान डेटा प्रकारों की 'कॉमा-सेपरेटेड लिस्ट' तय करें. उदाहरण के लिए, का इस्तेमाल करें.
X-Goog-FieldMask: places.displayName,places.formattedAddress
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैसभी फ़ील्ड फिर से पाने के लिए
*
का इस्तेमाल करें.X-Goog-FieldMask: *
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैइनमें से एक या ज़्यादा फ़ील्ड चुनें:
ये फ़ील्ड Text Search (सिर्फ़ आईडी) SKU को ट्रिगर करते हैं:
places.attributions
,places.id
,places.name
*,nextPageToken
*places.name
फ़ील्ड में जगह संसाधन का नाम शामिल होता है फ़ॉर्म में:places/PLACE_ID
.places.displayName
का इस्तेमाल करें किसी जगह के टेक्स्ट के नाम तक पहुंचने के लिए.ये फ़ील्ड टेक्स्ट सर्च (बेसिक) SKU को ट्रिगर करते हैं:
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.viewport
ये फ़ील्ड Text Search (ऐडवांस) SKU को ट्रिगर करते हैं:
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
ये फ़ील्ड Text Search (पसंदीदा) SKU को ट्रिगर करते हैं:
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.servesBeer
,places.servesBreakfast
,places.servesBrunch
,places.servesCocktails
,places.servesCoffee
,places.servesDessert
,places.servesDinner
,places.servesLunch
,places.servesVegetarianFood
,places.servesWine
,places.takeout
-
textQuery
वह टेक्स्ट स्ट्रिंग जिस पर खोजना है. उदाहरण के लिए: "रेस्टोरेंट", "123 मेन स्ट्रीट" या "सैन फ़्रांसिस्को में घूमने की सबसे अच्छी जगह". एपीआई विकल्प के आधार पर उम्मीदवार का मिलान और इस स्ट्रिंग से मेल खाने वाले नतीजे को क्रम में लगाकर, यह तय करता है कि वह कितने काम का है.
ज़रूरी नहीं पैरामीटर
includedType
इससे नतीजों को उन जगहों तक सीमित करता है जो इसके बताए गए टाइप से मेल खाते हैं टेबल A. सिर्फ़ एक टाइप चुना जा सकता है. उदाहरण के लिए:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
वह भाषा जिसमें नतीजे देने हैं.
- ज़्यादा जानकारी के लिए, इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google अक्सर इस्तेमाल की जाने वाली भाषाओं को अपडेट करता रहता है. इसलिए, हो सकता है कि यह सूची पूरी जानकारी.
-
अगर
languageCode
नहीं दिया जाता है, तो एपीआई डिफ़ॉल्ट रूप से यह वैल्यू सेट करता हैen
. अगर आप कोई अमान्य भाषा कोड डालते हैं, तो एपीआईINVALID_ARGUMENT
गड़बड़ी दिखाता है. - API, उस मोहल्ले का पता देने की पूरी कोशिश करता है जिसे आसानी से पढ़ा जा सकता है उपयोगकर्ता और स्थानीय लोग, दोनों को ध्यान में रखते हुए कार्रवाई की जा सकती है. उस लक्ष्य को हासिल करने के लिए, यह स्थानीय भाषा में पते, जिनके ज़रिए पढ़ने लायक स्क्रिप्ट में ट्रांसलिट्रेट किया गया हो ज़रूरत पड़ने पर, उपयोगकर्ता की पसंदीदा भाषा के हिसाब से. अन्य सभी पते पसंदीदा भाषा में दिए जाते हैं. पते के कॉम्पोनेंट ये हैं सभी उसी भाषा में लौटाए जाते हैं, जिसे पहले कॉम्पोनेंट.
- अगर कोई नाम पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे नज़दीकी मिलान.
- पसंदीदा भाषा का, नतीजों के सेट पर थोड़ा असर होता है एपीआई फिर से लौटाने का विकल्प चुनता है और उसके लौटाए जाने का क्रम तय करता है. कॉन्टेंट बनाने जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म को अलग-अलग तरीके से समझता है, जैसे, सड़क के नामों या समानार्थी शब्दों का इस्तेमाल एक भाषा में मान्य है, लेकिन दूसरी भाषा में नहीं.
locationBias
यह बताता है कि किसी इलाके को किस इलाके में खोजा जाना है. इस जगह की जानकारी पूर्वाग्रह के तौर पर है जिसका मतलब है बताई गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इनमें, नतीजे भी शामिल हैं का इस्तेमाल करें.
आपके पास
locationRestriction
याlocationBias
बताने का विकल्प है, लेकिन दोनों नहीं.locationRestriction
के बारे में सोचें कि वह क्षेत्र जिसमें परिणाम होने चाहिए औरlocationBias
इस रूप में वह क्षेत्र तय करते हुए जिसमें नतीजे इसके पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं क्षेत्र.इलाके की जानकारी एक आयताकार व्यूपोर्ट या सर्कल के तौर पर दें.
सर्कल को सेंटर पॉइंट और मीटर में रेडियस से तय किया जाता है. दायरा यह 0.0 और 50000.0 के बीच होना चाहिए. डिफ़ॉल्ट दायरा 0.0 है. उदाहरण के लिए:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
रेक्टैंगल, अक्षांश-देशांतर का व्यूपोर्ट होता है. इसे दो फ़ॉर्मैट में दिखाया जाता है नीचे और सबसे ऊपरी पॉइंट की ओर तिरछा रूप से आमने-सामने. निम्न बिंदु दक्षिण-पश्चिम को चिह्नित करता है आयत के कोने और सबसे ऊपरी बिंदु से उत्तर-पूर्व को दिखाया जाता है कोने में रखा जा सकता है.
व्यूपोर्ट को बंद क्षेत्र है, जिसका मतलब है इसकी सीमा शामिल है. अक्षांश की सीमाएं यह -90 से 90 डिग्री के बीच होना चाहिए, और देशांतर की सीमा यह -180 से 180 डिग्री के बीच होना चाहिए, जिसमें ये भी शामिल हैं:
- अगर
low
=high
है, तो व्यूपोर्ट में ये शामिल होते हैं समस्या को हल कर रहे हैं. - अगर
low.longitude
>high.longitude
, देशांतर की सीमा उल्टी है (व्यूपोर्ट ने 180 डिग्री को पार कर लिया है देशांतर लाइन). - अगर
low.longitude
= -180 डिग्री औरhigh.longitude
= 180 डिग्री, व्यूपोर्ट में सभी शामिल होते हैं देशांतर. - अगर
low.longitude
= 180 डिग्री औरhigh.longitude
= -180 डिग्री, देशांतर की रेंज है खाली. - अगर
low.latitude
>high.latitude
, अक्षांश रेंज खाली है.
कम और ज़्यादा, दोनों तरह की जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स नहीं होना चाहिए खाली. व्यूपोर्ट का खाली होने पर गड़बड़ी होती है.
उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- अगर
locationRestriction
यह बताता है कि किसी इलाके को किस इलाके में खोजा जाना है. चुने गए इलाके से बाहर के नतीजे नहीं दिखाए जा सकते वापस किया गया. इलाके की जानकारी एक आयताकार व्यूपोर्ट के तौर पर दें. ब्यौरा देखें
locationBias
में से देखें.आपके पास
locationRestriction
याlocationBias
बताने का विकल्प है, लेकिन दोनों नहीं.locationRestriction
के बारे में सोचें कि वह क्षेत्र जिसमें परिणाम होने चाहिए औरlocationBias
इस रूप में वह क्षेत्र तय करते हुए जिसमें नतीजे इसके पास होने चाहिए, लेकिन उसके बाहर भी हो सकते हैं क्षेत्र.-
maxनतीजेCount (अब सेवा में नहीं हैं)
हर पेज पर दिखाए जाने वाले नतीजों की संख्या (1 से 20 के बीच) तय करता है. उदाहरण के लिए,
maxResultCount
की वैल्यू को 5 पर सेट करने पर, 5 की वैल्यू मिलेगी पहले पेज पर नतीजे दिखाता है. अगर ऐसे और नतीजे हैं जिन्हें लौटाया जा सकता है क्वेरी के जवाब मेंnextPageToken
शामिल होता है, जिसे अगले पेज को ऐक्सेस करने के लिए बाद में अनुरोध कर सकता है. evOptions
उपलब्ध इलेक्ट्रिक वाहन (ईवी) की पहचान करने के लिए पैरामीटर तय करता है चार्जिंग कनेक्टर और चार्जिंग की दरें.
connectorTypes
किसी जगह पर मौजूद ईवी चार्जिंग कनेक्टर के टाइप के हिसाब से फ़िल्टर किए जा सकते हैं. ऐप्लिकेशन किसी भी कनेक्टर टाइप के साथ काम न करने वाली जगह को फ़िल्टर किया जाएगा बाहर. ईवी चार्जिंग कनेक्टर के साथ काम करने वाले कनेक्टर (एसी और डीसी) चार्जर, Tesla चार्जर, GB/T के साथ काम करने वाले चार्जर (ईवी फ़ास्ट चार्जिंग के लिए चीन) और वॉल आउटलेट चार्जर के साथ काम करते हैं. अधिक जानकारी के लिए, यह देखें दस्तावेज़.
minimumChargingRateKw
ईवी चार्जिंग की कम से कम दर के हिसाब से, जगहों को किलोवाट (किलोवॉट) में फ़िल्टर करता है. कोई भी जिन स्थानों पर चार्जिंग की न्यूनतम दर से कम शुल्क है, वे हैं फ़िल्टर करके बाहर किया गया. उदाहरण के लिए, चार्जिंग रेट वाले ईवी चार्जर ढूंढने के लिए कम से कम 10 kW हो, तो इस पैरामीटर को "10" पर सेट किया जा सकता है.
minRating
नतीजों को सिर्फ़ उन लोगों तक सीमित करता है जिनकी औसत उपयोगकर्ता रेटिंग या इस सीमा के बराबर. इसमें मान 0.0 और 5.0 (दोनों शामिल) के बीच होना चाहिए की बढ़ोतरी होगी. उदाहरण के लिए: 0, 0.5, 1.0, ... , 5.0, दोनों शामिल हैं. मान हैं को निकटतम 0.5 तक पूर्णांकित कर दिया जाता है. उदाहरण के लिए, 0.6 की वैल्यू सभी 1.0 से कम रेटिंग वाले नतीजे.
openNow
अगर
true
है, तो सिर्फ़ उन जगहों को दिखाएं जो कारोबार के लिए खुली हैं क्वेरी भेजते समय. अगर यहfalse
है, तो सभी कारोबारों को वापस करें चाहे ओपन स्टेटस कुछ भी हो. वे स्थान जो Google स्थल डेटाबेस में खुले होने का समय निर्दिष्ट नहीं करते हैं अगर इस पैरामीटर कोfalse
पर सेट किया जाता है, तो यह फ़ंक्शन दिखता है.pageSize
हर पेज पर दिखाए जाने वाले नतीजों की संख्या (1 से 20 के बीच) तय करता है. उदाहरण के लिए,
pageSize
की वैल्यू को 5 पर सेट करने पर, 5 की वैल्यू मिलेगी पहले पेज पर नतीजे दिखाता है. अगर ऐसे और नतीजे हैं जिन्हें लौटाया जा सकता है क्वेरी के जवाब मेंnextPageToken
शामिल होता है, जिसे अगले पेज को ऐक्सेस करने के लिए बाद में अनुरोध कर सकता है.pageToken
रिस्पॉन्स के मुख्य हिस्से से
nextPageToken
को बताता है पिछला पेज.-
priceLevels
खोज को उन जगहों तक सीमित करें जिन्हें कीमत के किसी खास लेवल पर मार्क किया गया है. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल को चुना जाता है.
से तय किए गए एक या ज़्यादा मानों की श्रेणी तय करें
PriceLevel
.उदाहरण के लिए:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
यह बताता है कि रिस्पॉन्स में नतीजों को किस तरह के क्वेरी:
- कैटगरी से जुड़ी क्वेरी के लिए, जैसे कि "रेस्टोरेंट इन न्यू यॉर्क सिटी" के लिए,
RELEVANCE
(खोज प्रासंगिकता के आधार पर रैंक नतीजे) डिफ़ॉल्ट है.rankPreference
कोRELEVANCE
पर सेट किया जा सकता है याDISTANCE
(दूरी के हिसाब से नतीजों को रैंक करें). - हमारा सुझाव है कि आप "माउंटेन व्यू, सीए" जैसी कैटगरी से जुड़ी अन्य क्वेरी के लिए जवाब दें
सेट न करें,
rankPreference
को सेट न करें.
- कैटगरी से जुड़ी क्वेरी के लिए, जैसे कि "रेस्टोरेंट इन न्यू यॉर्क सिटी" के लिए,
regionCode
जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्रीय कोड, जिसे दो वर्ण वाले CLDR कोड की वैल्यू. इस पैरामीटर का पक्षपात भी हो सकता है खोज के नतीजों में दिखने वाला है. कोई डिफ़ॉल्ट मान नहीं है.
अगर
formattedAddress
फ़ील्ड में देश का नाम जवाबregionCode
से मेल खा रहा है, इसलिए देश का कोड नहीं डाला गया हैformattedAddress
से. इस पैरामीटर का इस पर कोई असर नहीं होताadrFormatAddress
, जिसमें देश की जानकारी हमेशा शामिल होती है नाम उपलब्ध होने पर याshortFormattedAddress
पर डालें, जो कभी भी नहीं शामिल है.ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मेल खाते हैं. इसमें कुछ अहम अपवाद शामिल हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "यूके" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है (तकनीकी तौर पर, इकाई "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉदर्न आयरलैंड" है. पैरामीटर, लागू कानून के आधार पर नतीजों पर असर डाल सकता है.
strictTypeFiltering
includedType
पैरामीटर के साथ इस्तेमाल किया जाता है. जब इस पर सेट किया गया होtrue
, सिर्फ़ वे जगहें जो इसके बताए गए प्रकारों से मेल खाती हैंincludeType
लौटाए गए हैं. 'गलत' होने पर, डिफ़ॉल्ट तौर पर जवाब में ऐसी जगहें शामिल हो सकती हैं जो मेल नहीं खातीं दर्ज करें.
टेक्स्ट से जुड़े खोज के उदाहरण
क्वेरी स्ट्रिंग की मदद से कोई जगह ढूंढें
नीचे दिए गए उदाहरण में, इसके लिए टेक्स्ट खोज अनुरोध दिखाया गया है "ऑस्ट्रेलिया के सिडनी में मसालेदार शाकाहारी खाना":
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'
ध्यान दें कि X-Goog-FieldMask
हेडर से पता चलता है कि
जवाब
ये डेटा फ़ील्ड शामिल हैं: places.displayName,places.formattedAddress
.
इसके बाद, जवाब इस फ़ॉर्म में होगा:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
ज़्यादा जानकारी दिखाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें.
उदाहरण के लिए, निम्न को शामिल करने के लिए places.types,places.websiteUri
जोड़ें
और वेब पता
response:
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,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
जवाब अब इस फ़ॉर्म में है:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
मूल्य स्तर के आधार पर स्थान फ़िल्टर करें
रेस्टोरेंट के हिसाब से नतीजे फ़िल्टर करने के लिए, priceLevel
विकल्प का इस्तेमाल करें
सस्ता या थोड़ा महंगा बताया गया है:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
इस उदाहरण में, X-Goog-FieldMask
हेडर का इस्तेमाल करके
places.priceLevel
डेटा फ़ील्ड को
जवाब
इसलिए यह इस रूप में होगा:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
खोज को बेहतर बनाने के लिए दूसरे विकल्प जोड़ें, जैसे कि includedType
,
minRating
, rankPreference
, openNow
,
और इसमें बताए गए अन्य पैरामीटर
वैकल्पिक पैरामीटर.
किसी इलाके में जगहें खोजना
locationRestriction
या locationBias
का इस्तेमाल करें,
खोज को किसी क्षेत्र तक सीमित करने के लिए, दोनों का इस्तेमाल नहीं किया जा सकता. locationRestriction
के बारे में सोचें
बताएं कि नतीजे किस क्षेत्र में होने चाहिए और locationBias
जैसे कि उस इलाके के बारे में बताएं जिसमें नतीजे इसके पास होने चाहिए, लेकिन
क्षेत्र.
नीचे दिए गए उदाहरण में, इसके लिए टेक्स्ट खोज अनुरोध दिखाया गया है "मसालेदार शाकाहारी भोजन" किसी पॉइंट के 500 मीटर के दायरे में होना दिल्ली में स्थित है. यह अनुरोध, इसके लिए केवल पहले 10 परिणाम लौटाता है जो खुले हैं.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -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'
ऐसे ईवी चार्जर खोजें जिनकी चार्जिंग की कम से कम दर तय की गई है
इसके लिए, minimumChargingRateKw
और connectorTypes
का इस्तेमाल करें
अपने ईवी के साथ काम करने वाले चार्जर वाली जगहें खोजो.
यहां दिए गए उदाहरण में, Tesla और J1772 टाइप 1 ईवी चार्जिंग का अनुरोध दिखाया गया है माउंटेन व्यू, कैलिफ़ोर्निया में चार्जिंग की कम से कम 10 किलोवाट दर वाले कनेक्टर. सिर्फ़ चार नतीजे मिले.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
अनुरोध करने पर यह रिस्पॉन्स मिलता है:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
प्रति पेज लौटाने के लिए परिणामों की संख्या दर्ज करें
नतीजे की संख्या तय करने के लिए pageSize
पैरामीटर का इस्तेमाल करें
रिटर्न प्रति पेज. रिस्पॉन्स के मुख्य हिस्से में मौजूद nextPageToken
पैरामीटर
से एक टोकन मिलता है. इसका इस्तेमाल अगले कॉल में किया जा सकता है, ताकि
नतीजे.
नीचे दिए गए उदाहरण में, "न्यूयॉर्क में पिज़्ज़ा" के लिए अनुरोध दिखाया गया है ज़्यादा से ज़्यादा पांच प्रति पेज परिणाम:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
परिणामों के अगले पेज पर जाने के लिए, pageToken
का उपयोग करके
अनुरोध के मुख्य भाग में nextPageToken
:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
इसे आज़माएं!
एपीआई एक्सप्लोरर की मदद से, सैंपल के तौर पर अनुरोध किए जा सकते हैं. को एपीआई और एपीआई विकल्पों के बारे में अच्छे से जान सकते हैं.
एपीआई का आइकॉन
चुनें. पर क्लिक करें.
विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और
fields
सेट करें पैरामीटर को फ़ील्ड से मास्क.विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.
लागू करें बटन चुनें. पॉप-अप डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, 'बड़ा करें' आइकॉन को चुनें. एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए,
.