टेक्स्ट सर्च (नया)

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

टेक्स्ट खोज (नया) किसी स्ट्रिंग के आधार पर स्थानों के सेट के बारे में जानकारी देता है — उदाहरण के लिए "दिल्ली में पिज़्ज़ा" या "ओटावा के आस-पास जूतों की दुकान" या "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"
}

इसे आज़माएं!

एपीआई एक्सप्लोरर की मदद से, सैंपल के तौर पर अनुरोध किए जा सकते हैं. को एपीआई और एपीआई विकल्पों के बारे में अच्छे से जान सकते हैं.

  1. एपीआई का आइकॉन एपीआई एक्सप्लोरर को बड़ा करें. चुनें. पर क्लिक करें.

  2. विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और fields सेट करें पैरामीटर को फ़ील्ड से मास्क.

  3. विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.

  4. लागू करें बटन चुनें. पॉप-अप डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

  5. एपीआई एक्सप्लोरर पैनल में, 'बड़ा करें' आइकॉन को चुनें. एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, एपीआई एक्सप्लोरर को बड़ा करें..