Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

टेक्स्ट से खोजें (नई सुविधा)

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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

टेक्स्ट से खोजें (नई सुविधा) किसी स्ट्रिंग के आधार पर, जगहों के एक सेट के बारे में जानकारी देती है. उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के आस-पास जूते की दुकानें" या "123 मेन स्ट्रीट". यह सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से, जगहों की सूची दिखाती है.

ज़रूरी पैरामीटर के साथ-साथ, टेक्स्ट से खोजें (नया) में बेहतर नतीजे पाने के लिए, वैकल्पिक पैरामीटर का इस्तेमाल करके क्वेरी को बेहतर बनाया जा सकता है.

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

इसे आज़माएं!

टेक्स्ट से खोजें (नया) के अनुरोध

टेक्स्ट से खोजें (नया) का अनुरोध, इस तरह का एचटीटीपी पोस्ट अनुरोध होता है:

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: *
```
डेवलपमेंट के दौरान, वाइल्डकार्ड (*) का इस्तेमाल किया जा सकता है. हालांकि, Google प्रोडक्शन में वाइल्डकार्ड रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करने का सुझाव नहीं देता है. ऐसा इसलिए, क्योंकि इससे बहुत ज़्यादा डेटा मिल सकता है.

places.iconMaskBaseUri और places.iconBackgroundColor का इस्तेमाल करने के बारे में ज़्यादा जानकारी, जगह के आइकॉन सेक्शन में देखी जा सकती है.

इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:
- इन फ़ील्ड से, सिर्फ़ आईडी वाला SKU, टेक्स्ट से खोजें के लिए ज़रूरी शर्तें पूरी करता है ट्रिगर होता है:
  places.attributions
  places.id
  places.consumerAlert
  places.name^*
  nextPageToken
  places.movedPlace
  places.movedPlaceId
  ^* places.name फ़ील्ड में, जगह के संसाधन का नाम इस फ़ॉर्मैट में होता है: places/PLACE_ID. जगह के नाम को टेक्स्ट के तौर पर ऐक्सेस करने के लिए, Pro SKU में places.displayName का इस्तेमाल करें.
  
  फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
- इन फ़ील्ड में टेक्स्ट से खोजें Pro SKU ट्रिगर होता है:
  places.accessibilityOptions
  places.addressComponents
  places.addressDescriptor^*
  places.adrFormatAddress
  places.businessStatus
  places.containingPlaces
  places.displayName
  places.formattedAddress
  places.googleMapsLinks
  places.googleMapsTypeLabel
  places.googleMapsUri
  places.iconBackgroundColor
  places.iconMaskBaseUri
  places.location
  places.openingDate
  places.photos
  places.plusCode
  places.postalAddress
  places.primaryType
  places.primaryTypeDisplayName
  places.pureServiceAreaBusiness
  places.shortFormattedAddress
  places.searchUri
  places.subDestinations
  places.timeZone
  places.types
  places.utcOffsetMinutes
  places.viewport
  
  ^* पता बताने वाले शब्दों का इस्तेमाल करने की सुविधा, भारत में रहने वाले लोगों के लिए उपलब्ध है. अन्य देशों/इलाकों में, यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.
  फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
- इन फ़ील्ड से टेक्स्ट से खोजें Enterprise एसकेयू ट्रिगर होता है:
  places.currentOpeningHours
  places.currentSecondaryOpeningHours
  places.internationalPhoneNumber
  places.nationalPhoneNumber
  places.priceLevel
  places.priceRange
  places.rating
  places.regularOpeningHours
  places.regularSecondaryOpeningHours
  places.transitStation
  places.userRatingCount
  places.websiteUri
  फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.
- इन फ़ील्ड से, टेक्स्ट से खोजें Enterprise + Atmosphere एसकेयू ट्रिगर होता है:
  places.allowsDogs
  places.curbsidePickup
  places.delivery
  places.dineIn
  places.editorialSummary
  places.evChargeAmenitySummary
  places.evChargeOptions
  places.fuelOptions
  places.generativeSummary
  places.goodForChildren
  places.goodForGroups
  places.goodForWatchingSports
  places.liveMusic
  places.menuForChildren
  places.neighborhoodSummary
  places.parkingOptions
  places.paymentOptions
  places.outdoorSeating
  places.reservable
  places.restroom
  places.reviews
  places.reviewSummary
  routingSummaries^*
  places.servesBeer
  places.servesBreakfast
  places.servesBrunch
  places.servesCocktails
  places.servesCoffee
  places.servesDessert
  places.servesDinner
  places.servesLunch
  places.servesVegetarianFood
  places.servesWine
  places.takeout
  
  ^* सिर्फ़ टेक्स्ट से खोजें और आस-पास की जगहों की जानकारी
  फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

textQuery

वह टेक्स्ट स्ट्रिंग जिसमें खोजना है. उदाहरण के लिए, "रेस्टोरेंट", "123 मेन स्ट्रीट" या "सैन फ़्रांसिस्को में घूमने के लिए सबसे अच्छी जगह". यह एपीआई, इस स्ट्रिंग के आधार पर संभावित मैच दिखाता है. साथ ही, नतीजों को उनकी अहमियत के हिसाब से क्रम में लगाता है.

टेक्स्ट से खोजें (नया वर्शन) को ऐसी क्वेरी के लिए नहीं बनाया गया है जिनके बारे में साफ़ तौर पर जानकारी नहीं दी गई है. इनमें ये क्वेरी शामिल हैं:

क्वेरी का टाइप	उदाहरण
एक ही क्वेरी में कई जगहों, सड़कों या शहरों के नाम जैसी कई अवधारणाएं या पाबंदियां शामिल हों	"सैन फ़्रांसिस्को की मार्केट स्ट्रीट से सैन होज़े हवाई अड्डे तक"
डाक पते के एलिमेंट, Google Maps पर नहीं दिखाए गए हैं	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
कारोबार, चेन या कैटगरी के नाम के साथ उन जगहों के नाम जोड़ना जहां ये उपलब्ध नहीं हैं	"डैलस, टेक्सस के पास मौजूद टेस्को स्टोर"
ऐसी क्वेरी जिनके कई मतलब निकल सकते हैं	"चार्जर वापस करने की सुविधा"
पुराने नाम, जो अब इस्तेमाल नहीं किए जाते	"मिडलसेक्स यूनाइटेड किंगडम"
जियोस्पेशल एलिमेंट या इंटेंट का न होना	"वेंचुरा हार्बर में कितनी नावें हैं?"
गैर-आधिकारिक या बनावटी नाम	"The Jenga" "The Helter Skelter"
अक्षांश और देशांतर निर्देशांक	"37.422131,-122.084801"

ध्यान दें: फ़ोन नंबर से खोजते समय सबसे अच्छे नतीजे पाने के लिए, देश का कोड डालें और उसके बाद स्पेस दें. साथ ही, regionCode पैरामीटर को देश के कोड के हिसाब से सेट करें. फ़ोन नंबर के फ़ॉर्मैट, देश के हिसाब से अलग-अलग होते हैं. एपीआई, इन अलग-अलग फ़ॉर्मैट के लिए नतीजे दिखाता है. Places API (New), मान्य फ़ोन नंबरों के लिए E.164 फ़ॉर्मैट का इस्तेमाल करता है. अक्षर वाले वर्णों को E.161 कीपैड मैपिंग के आधार पर बदला जाता है.

ज़रूरी नहीं पैरामीटर

includeFutureOpeningBusinesses

अगर true है, तो यह उन कारोबारों को दिखाता है जो आने वाले समय में खुलने वाले हैं. डिफ़ॉल्ट रूप से, यह false पर सेट होता है.

कारोबार की स्थिति वापस पाने के लिए, अपने अनुरोध फ़ील्ड मास्क में places.businessStatus शामिल करें. कारोबार के खुलने की अनुमानित तारीख पाने के लिए, अपने अनुरोध फ़ील्ड मास्क में places.openingDate शामिल करें.
includedType

टेबल A में तय किए गए टाइप से मेल खाने वाली जगहों के हिसाब से, नतीजों को प्राथमिकता देता है. सिर्फ़ एक टाइप तय किया जा सकता है. उदाहरण के लिए:
- "includedType":"bar"
- "includedType":"pharmacy"
ध्यान दें: टेबल B में मौजूद वैल्यू, सिर्फ़ जवाब में दिखती हैं. टेबल B में मौजूद वैल्यू का इस्तेमाल, फ़िल्टर के तौर पर नहीं किया जा सकता.

टेक्स्ट से खोजें (नया वर्शन) की सुविधा, कुछ क्वेरी के लिए टाइप फ़िल्टरिंग लागू करती है. यह सुविधा, लागू होने के हिसाब से काम करती है. उदाहरण के लिए, हो सकता है कि टाइप के हिसाब से फ़िल्टर करने की सुविधा, किसी खास पते ("123 मेन स्ट्रीट") के लिए की गई क्वेरी पर लागू न हो. हालांकि, कैटगरी के हिसाब से की गई क्वेरी ("आस-पास के स्टोर" या "शॉपिंग मॉल") पर, टाइप के हिसाब से फ़िल्टर करने की सुविधा हमेशा लागू होती है.

सभी क्वेरी पर टाइप फ़िल्टरिंग लागू करने के लिए, strictTypeFiltering को true पर सेट करें.

यह पैरामीटर, होटल या भू-राजनीतिक क्वेरी पर लागू नहीं होता. उदाहरण के लिए, राज्य, इलाके, पिन कोड, स्कूल डिस्ट्रिक्ट या देशों से जुड़ी क्वेरी.
includePureServiceAreaBusinesses

true पर सेट होने पर, जवाब में ऐसे कारोबार शामिल होते हैं जो ग्राहकों को सीधे तौर पर सेवाएं देते हैं या उनसे संपर्क करते हैं. हालांकि, उनके पास कारोबार की कोई जगह नहीं होती. अगर इसे false पर सेट किया जाता है, तो एपीआई सिर्फ़ उन कारोबारों की जानकारी दिखाता है जिनकी काम करने की कोई तय जगह हो.
languageCode

वह भाषा जिसमें नतीजे दिखाने हैं.
- उपलब्ध भाषाओं की सूची देखें. Google, अक्सर इस्तेमाल की जा सकने वाली भाषाओं को अपडेट करता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
- अगर languageCode की वैल्यू नहीं दी जाती है, तो एपीआई डिफ़ॉल्ट रूप से en की वैल्यू का इस्तेमाल करता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआई INVALID_ARGUMENT गड़बड़ी का मैसेज दिखाता है.
- एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों आसानी से पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. साथ ही, अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा के हिसाब से, पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सके. अन्य सभी पते, पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट पर पड़ता है. साथ ही, इससे यह तय होता है कि नतीजे किस क्रम में दिखाए जाएंगे. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
locationBias

खोजने के लिए कोई हिस्सा तय करता है. इस जगह को पूर्वाग्रह के तौर पर इस्तेमाल किया जाता है. इसका मतलब है कि बताई गई जगह के आस-पास के नतीजे दिखाए जा सकते हैं. इसमें बताई गई जगह से बाहर के नतीजे भी शामिल हो सकते हैं.

locationRestriction या locationBias में से किसी एक को तय किया जा सकता है, लेकिन दोनों को नहीं. locationRestriction को उस क्षेत्र के तौर पर समझें जहां नतीजे होने चाहिए. वहीं, locationBias को उस क्षेत्र के तौर पर समझें जहां नतीजे होने की संभावना है. हालांकि, नतीजे उस क्षेत्र के बाहर भी हो सकते हैं.

ध्यान दें: अगर आपने locationBias और locationRestriction, दोनों को शामिल नहीं किया है, तो एपीआई डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है. आईपी बायसिंग की सुविधा चालू होने पर, एपीआई डिवाइस के आईपी पते का इस्तेमाल करके, नतीजों को बायस करता है.

ध्यान दें: अगर textQuery में Market in Barcelona जैसी कोई साफ़ तौर पर बताई गई जगह शामिल है, तो locationBias पैरामीटर को बदला जा सकता है. इस मामले में, locationBias को अनदेखा कर दिया जाता है.

क्षेत्र को रेक्टैंगुलर व्यूपोर्ट या सर्कल के तौर पर तय करें.
- किसी सर्कल को उसके केंद्र बिंदु और मीटर में दी गई त्रिज्या से तय किया जाता है. रेडियस, 0.0 और 50,000.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 का मतलब है कि नतीजे उस क्षेत्र के अंदर या आस-पास होने चाहिए, लेकिन वे उस क्षेत्र से बाहर भी हो सकते हैं.

ध्यान दें: अगर आपने locationBias और locationRestriction, दोनों को शामिल नहीं किया है, तो एपीआई डिफ़ॉल्ट रूप से आईपी बायसिंग का इस्तेमाल करता है. आईपी पते के आधार पर नतीजे दिखाने की सुविधा चालू होने पर, एपीआई डिवाइस के आईपी पते का इस्तेमाल करके नतीजे दिखाता है.
maxResultCount (अब सेवा में नहीं है)

काम नहीं करता: इस फ़ील्ड की जगह अब pageSize का इस्तेमाल किया जाता है. अगर maxResultCount और pageSize, दोनों की वैल्यू दी गई हैं, तो pageSize का इस्तेमाल किया जाएगा और maxResultCount को अनदेखा कर दिया जाएगा.

इससे हर पेज पर दिखाए जाने वाले नतीजों की संख्या (1 से 20 के बीच) तय की जाती है. उदाहरण के लिए, maxResultCount की वैल्यू 5 सेट करने पर, पहले पेज पर ज़्यादा से ज़्यादा पांच नतीजे दिखेंगे. अगर क्वेरी के ज़्यादा नतीजे दिखाए जा सकते हैं, तो जवाब में एक nextPageToken शामिल होता है. इसे अगले पेज को ऐक्सेस करने के लिए, बाद के अनुरोध में पास किया जा सकता है.

ध्यान दें: अगर maxResultCount की वैल्यू 0 है या इसके बारे में नहीं बताया गया है, तो एपीआई डिफ़ॉल्ट रूप से हर पेज पर 20 नतीजे दिखाएगा. अगर maxResultCount की वैल्यू 20 से ज़्यादा है, तो एपीआई हर पेज पर ज़्यादा से ज़्यादा 20 नतीजे दिखाएगा.
evOptions

इससे इलेक्ट्रिक वाहन (ईवी) चार्जिंग कनेक्टर और चार्जिंग रेट की पहचान करने के लिए पैरामीटर तय किए जाते हैं.
- connectorTypes
  
  किसी जगह पर उपलब्ध ईवी चार्जिंग कनेक्टर के टाइप के हिसाब से फ़िल्टर करता है. ऐसी जगहें फ़िल्टर कर दी जाएंगी जहां किसी भी तरह का कनेक्टर मौजूद नहीं है. इन टाइप के ईवी चार्जिंग कनेक्टर के लिए, यह सुविधा काम करती है: कंबाइंड (एसी और डीसी) चार्जर, Tesla चार्जर, GB/T के मुताबिक बने चार्जर (चीन में ईवी को तेज़ी से चार्जिंग की सुविधा देने के लिए), और दीवार पर लगा पावर सॉकेट चार्जर. ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ देखें.
  - इस्तेमाल किए जा सकने वाले किसी खास कनेक्टर के नतीजों को फ़िल्टर करने के लिए, connectorTypes को उस वैल्यू पर सेट करें. उदाहरण के लिए, J1772 टाइप 1 कनेक्टर ढूंढने के लिए, connectorTypes को EV_CONNECTOR_TYPE_J1772 पर सेट करें.
  - इस्तेमाल न किए जा सकने वाले कनेक्टर के नतीजे फ़िल्टर करने के लिए, connectorTypes को EV_CONNECTOR_TYPE_OTHER पर सेट करें.
  - दीवार पर लगे पावर सॉकेट वाले किसी भी कनेक्टर टाइप के नतीजों को फ़िल्टर करने के लिए, connectorTypes को EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET पर सेट करें.
  - किसी भी कनेक्टर टाइप के लिए नतीजों को फ़िल्टर करने के लिए, connectorTypes को EV_CONNECTOR_TYPE_UNSPECIFIED पर सेट करें या connectorTypes के लिए कोई वैल्यू सेट न करें.
- minimumChargingRateKw
  
  यह फ़िल्टर, किलोवॉट (kW) में ईवी चार्जिंग की सबसे कम दर के हिसाब से जगहों को फ़िल्टर करता है. जिन जगहों पर चार्जिंग की दर, कम से कम चार्जिंग दर से कम है उन्हें फ़िल्टर कर दिया जाता है. उदाहरण के लिए, अगर आपको ऐसे ईवी चार्जर ढूंढने हैं जिनकी चार्जिंग दर कम से कम 10 किलोवॉट है, तो इस पैरामीटर को "10" पर सेट करें.
minRating

नतीजों को सिर्फ़ उन लोगों तक सीमित करता है जिनकी औसत उपयोगकर्ता रेटिंग, इस सीमा से ज़्यादा या इसके बराबर है. वैल्यू, 0.0 और 5.0 के बीच की होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. साथ ही, वैल्यू 0.5 के इंक्रीमेंट में होनी चाहिए. उदाहरण के लिए: 0, 0.5, 1.0, ... , 5.0 शामिल है. वैल्यू को सबसे नज़दीकी 0.5 तक पूर्णांक बनाया जाता है. उदाहरण के लिए, 0.6 की वैल्यू से, 1.0 से कम रेटिंग वाले सभी नतीजे हट जाते हैं.

यह पैरामीटर, होटल या भू-राजनीतिक क्वेरी पर लागू नहीं होता. उदाहरण के लिए, राज्य, इलाके, पिन कोड, स्कूल डिस्ट्रिक्ट या देशों से जुड़ी क्वेरी.
openNow

अगर true, तो सिर्फ़ उन जगहों की जानकारी दिखाओ जो क्वेरी भेजे जाने के समय कारोबार के लिए खुली हों. अगर false है, तो सभी कारोबारों की जानकारी दिखाएं. भले ही, वे खुले हों या नहीं. अगर इस पैरामीटर को false पर सेट किया जाता है, तो Google Places के डेटाबेस में ऐसी जगहों की जानकारी दिखती है जिनके कारोबार के खुले होने का समय नहीं बताया गया है.

यह पैरामीटर, होटल या भू-राजनीतिक क्वेरी पर लागू नहीं होता. उदाहरण के लिए, राज्य, इलाके, पिन कोड, स्कूल डिस्ट्रिक्ट या देशों से जुड़ी क्वेरी.
pageSize

इससे पता चलता है कि हर पेज पर कितने नतीजे (1 से 20 के बीच) दिखाने हैं. उदाहरण के लिए, pageSize की वैल्यू 5 पर सेट करने से, पहले पेज पर ज़्यादा से ज़्यादा पांच नतीजे दिखेंगे. अगर क्वेरी के ज़्यादा नतीजे दिखाए जा सकते हैं, तो जवाब में एक nextPageToken शामिल होता है. इसे अगले पेज को ऐक्सेस करने के लिए, बाद के अनुरोध में पास किया जा सकता है.

ध्यान दें: अगर pageSize की वैल्यू 0 है या कोई वैल्यू नहीं दी गई है, तो एपीआई डिफ़ॉल्ट रूप से हर पेज पर 20 नतीजे दिखाएगा. अगर pageSize की वैल्यू 20 से ज़्यादा है, तो एपीआई हर पेज पर ज़्यादा से ज़्यादा 20 नतीजे दिखाएगा.
pageToken

पिछले पेज के रिस्पॉन्स के मुख्य हिस्से से nextPageToken के बारे में बताता है.
priceLevels

खोज के नतीजों को उन जगहों तक सीमित करें जिन्हें कीमत के कुछ लेवल पर मार्क किया गया है. डिफ़ॉल्ट रूप से, सभी प्राइस लेवल चुने जाते हैं.

इन जगहों के लिए, कीमत के लेवल की जानकारी मिल सकती है:
अगर priceLevels को चुना जाता है, तो जवाब में उन जगहों को शामिल नहीं किया जाएगा जो खोज के लिए उपलब्ध नहीं हैं.

PriceLevel से तय की गई एक या उससे ज़्यादा वैल्यू का ऐरे डालें.

उदाहरण के लिए:
```
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
```
ध्यान दें: PRICE_LEVEL_FREE को अनुरोध में शामिल नहीं किया जा सकता. इसका इस्तेमाल सिर्फ़ जवाब देने के लिए किया जाता है.

यह पैरामीटर, होटल या भू-राजनीतिक क्वेरी पर लागू नहीं होता. उदाहरण के लिए, राज्य, इलाके, पिन कोड, स्कूल डिस्ट्रिक्ट या देशों से जुड़ी क्वेरी.
rankPreference

इससे यह तय होता है कि क्वेरी के टाइप के आधार पर, जवाब में नतीजों को कैसे रैंक किया जाता है:
- "न्यूयॉर्क शहर में रेस्टोरेंट" जैसी कैटगरी वाली क्वेरी के लिए, RELEVANCE (खोज के नतीजों को खोज के कितना सही है के हिसाब से रैंक करना) डिफ़ॉल्ट रूप से चालू होता है. rankPreference को RELEVANCE या DISTANCE (दूरी के हिसाब से नतीजों को रैंक करें) पर सेट किया जा सकता है.
- "माउंटेन व्यू, कैलिफ़ोर्निया" जैसी कैटगरी में शामिल न की गई क्वेरी के लिए, हमारा सुझाव है कि rankPreference को सेट न करें.
यह पैरामीटर, होटल से जुड़ी क्वेरी या जियोपॉलिटिकल क्वेरी पर लागू नहीं होता. जैसे, प्रशासनिक इलाकों, मोहल्लों, पिन कोड, स्कूल डिस्ट्रिक्ट या देशों से जुड़ी क्वेरी.
regionCode

जवाब को फ़ॉर्मैट करने के लिए इस्तेमाल किया जाने वाला क्षेत्र कोड. इसे दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर बताया जाता है. इस पैरामीटर की वजह से, खोज के नतीजों पर पक्षपात का असर भी पड़ सकता है. इसकी कोई डिफ़ॉल्ट वैल्यू नहीं होती.

अगर जवाब में formattedAddress फ़ील्ड में मौजूद देश का नाम, regionCode से मेल खाता है, तो formattedAddress से देश का कोड हटा दिया जाता है. इस पैरामीटर का adrFormatAddress पर कोई असर नहीं पड़ता. इसमें देश का नाम हमेशा शामिल होता है, बशर्ते वह उपलब्ध हो. इसके अलावा, shortFormattedAddress पर भी इसका कोई असर नहीं पड़ता, क्योंकि इसमें देश का नाम कभी शामिल नहीं होता.

ज़्यादातर CLDR कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ मामलों में ये अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन और नॉदर्न आयरलैंड" के लिए है. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है.
strictTypeFiltering

इसका इस्तेमाल includedType पैरामीटर के साथ किया जाता है. true पर सेट होने पर, सिर्फ़ वे जगहें दिखाई जाती हैं जो includedType में बताए गए टाइप से मेल खाती हैं. डिफ़ॉल्ट रूप से यह वैल्यू गलत होती है. ऐसा होने पर, जवाब में ऐसी जगहें शामिल हो सकती हैं जो बताए गए टाइप से मेल नहीं खातीं.

टेक्स्ट से खोज (नई सुविधा) के उदाहरण

क्वेरी स्ट्रिंग की मदद से कोई जगह ढूंढना

यहां "सिडनी, ऑस्ट्रेलिया में तीखा शाकाहारी खाना" के लिए, टेक्स्ट से खोजें (नया) सुविधा के अनुरोध का उदाहरण दिया गया है:

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 जोड़ें:

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 का मतलब है कि नतीजे उस इलाके के आस-पास के होने चाहिए जो आपने चुना है. हालांकि, नतीजे उस इलाके से बाहर के भी हो सकते हैं.

ध्यान दें: locationRestriction का इस्तेमाल करते समय, सिर्फ़ आयताकार व्यूपोर्ट के तौर पर क्षेत्र की जानकारी दी जा सकती है. locationBias का इस्तेमाल करते समय, क्षेत्र को आयताकार व्यूपोर्ट या सर्कल के तौर पर तय किया जा सकता है.

locationRestriction का इस्तेमाल करके, किसी इलाके को प्रतिबंधित करना

locationRestriction पैरामीटर का इस्तेमाल करके, क्वेरी के नतीजों को किसी खास इलाके तक सीमित करें. अपने अनुरोध के मुख्य हिस्से में, low और high अक्षांश और देशांतर की वैल्यू डालें. इनसे क्षेत्र की सीमा तय होती है.

यहां न्यूयॉर्क शहर में "शाकाहारी खाना" के लिए, टेक्स्ट से खोजें (नया) के अनुरोध का उदाहरण दिया गया है. इस अनुरोध से, खुली हुई जगहों के लिए सिर्फ़ पहले 10 नतीजे दिखते हैं.

curl -X POST -d '{
  "textQuery" : "vegetarian food",
  "pageSize" : "10",
  "locationRestriction": {
    "rectangle": {
      "low": {
        "latitude": 40.477398,
        "longitude": -74.259087
      },
      "high": {
        "latitude": 40.91618,
        "longitude": -73.70018
      }
    }
  }
}' \
  -H 'Content-Type: application/json' \
  -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.id,places.formattedAddress' \
  'https://places.googleapis.com/v1/places:searchText'

locationBias का इस्तेमाल करके, किसी इलाके को प्राथमिकता देना

यहां दिए गए उदाहरण में, "शाकाहारी खाना" के लिए टेक्स्ट से खोज (नया वर्शन) का अनुरोध दिखाया गया है. यह अनुरोध, सैन फ़्रांसिस्को के डाउनटाउन में मौजूद किसी जगह से 500 मीटर के दायरे में मौजूद जगह के लिए किया गया है. इस अनुरोध में, सिर्फ़ उन जगहों के पहले 10 नतीजे दिखाए जाते हैं जो खुली हैं.

curl -X POST -d '{
  "textQuery" : "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
          }
        ]
      }
    }
  ]
}

घर या दुकान पर सेवा देने वाले कारोबारों को खोजना

includePureServiceAreaBusinesses पैरामीटर का इस्तेमाल करके, ऐसे कारोबारों को खोजें जिनका कोई स्टोर नहीं है. उदाहरण के लिए, जगह-जगह जाकर सफ़ाई करने की सेवा या फ़ूड ट्रक.

यहां सैन फ़्रांसिस्को में प्लंबर के लिए किए गए अनुरोध का उदाहरण दिया गया है:

curl -X POST -d '{
  "textQuery" : "plumber San Francisco",
  "includePureServiceAreaBusinesses": true
}' \
-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'

जवाब में, सेवा देने के पते के बिना कारोबारों में formattedAddress फ़ील्ड शामिल नहीं होता है:

{
  "places": [
    {
      "formattedAddress": "3450 Sacramento St #204, San Francisco, CA 94118, USA",
      "displayName": {
        "text": "Advanced Plumbing & Drain",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "1455 Bancroft Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Magic Plumbing Heating & Cooling",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Starboy Plumbing Inc.",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "78 Dorman Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Cabrillo Plumbing, Heating & Air",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "540 Barneveld Ave # D, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Mr. Rooter Plumbing of San Francisco",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Pipeline Plumbing",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "350 Bay St #100-178, San Francisco, CA 94133, USA",
      "displayName": {
        "text": "One Source Plumbing and Rooter",
        "languageCode": "en"
      }
    },
    /.../
  ]
}

हर पेज पर दिखाए जाने वाले नतीजों की संख्या तय करना

हर पेज पर दिखाए जाने वाले नतीजों की संख्या तय करने के लिए, 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"
}

नतीजों के अगले पेज को ऐक्सेस करने के लिए, अनुरोध के मुख्य हिस्से में nextPageToken पास करने के लिए pageToken का इस्तेमाल करें:

 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"
}

दिखाता है.

Address descriptors पाना

पता बताने वाले डिस्क्रिप्टर, किसी जगह की जानकारी देते हैं. इसमें आस-पास के लैंडमार्क और इलाके शामिल होते हैं.

ध्यान दें: पते के बारे में खास जानकारी बताने की सुविधा, भारत में खरीदारों के लिए सामान्य रूप से उपलब्ध है. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. Places API (नया) के ऐसे अनुरोधों के लिए एसकेयू: Places API टेक्स्ट से खोजें Pro के हिसाब से बिलिंग की जाएगी जिनमें फ़ील्ड मास्क में सिर्फ़ addressDescriptor का इस्तेमाल किया गया है.

यहां सैन होज़े के एक मॉल के आस-पास की जगहों के लिए, टेक्स्ट से खोजें (नया) के अनुरोध का उदाहरण दिया गया है. इस उदाहरण में, फ़ील्ड मास्क में addressDescriptors को शामिल किया गया है:

curl -X POST -d '{
  "textQuery": "clothes",
  "maxResultCount": 5,
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.321328,
        "longitude": -121.946275
      }
    }
  },
  "rankPreference":"RANK_PREFERENCE_UNSPECIFIED"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.addressDescriptor" \
https://places.googleapis.com/v1/places:searchText

जवाब में, अनुरोध में बताई गई जगह, आस-पास के लैंडमार्क की सूची और जगह से उनकी दूरी, और इलाकों की सूची और जगह से उनके संबंध की जानकारी शामिल होती है:

  {
  "places": [
    {
      "displayName": {
        "text": "Urban Outfitters",
        "languageCode": "en"
      },
      "addressDescriptor": {
        "landmarks": [
          {
            "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
            "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
            "displayName": {
              "text": "Westfield Valley Fair",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "food",
              "movie_theater",
              "point_of_interest",
              "restaurant",
              "shoe_store",
              "shopping_mall",
              "store"
            ],
            "spatialRelationship": "WITHIN",
            "straightLineDistanceMeters": 133.72855
          },
          {
            "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
            "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
            "displayName": {
              "text": "Nordstrom",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "point_of_interest",
              "shoe_store",
              "store"
            ],
            "straightLineDistanceMeters": 250.99161
          },
          {
            "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
            "placeId": "ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
            "displayName": {
              "text": "Macy's",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "point_of_interest",
              "store"
            ],
            "straightLineDistanceMeters": 116.24196
          },
          {
            "name": "places/ChIJ9d3plB_Lj4ARzyaU5bn80WY",
            "placeId": "ChIJ9d3plB_Lj4ARzyaU5bn80WY",
            "displayName": {
              "text": "Bank of America Financial Center",
              "languageCode": "en"
            },
            "types": [
              "bank",
              "establishment",
              "finance",
              "point_of_interest"
            ],
            "straightLineDistanceMeters": 121.61515
          },
          {
            "name": "places/ChIJaXCjxvXLj4ARCPmQpvJ52Lw",
            "placeId": "ChIJaXCjxvXLj4ARCPmQpvJ52Lw",
            "displayName": {
              "text": "Bloomingdale's",
              "languageCode": "en"
            },
            "types": [
              "clothing_store",
              "department_store",
              "establishment",
              "furniture_store",
              "home_goods_store",
              "point_of_interest",
              "shoe_store",
              "store"
            ],
            "straightLineDistanceMeters": 81.32396
          }
        ],
        "areas": [
          {
            "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
            "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
            "displayName": {
              "text": "Westfield Valley Fair",
              "languageCode": "en"
            },
            "containment": "WITHIN"
          },
          {
            "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
            "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
            "displayName": {
              "text": "Valley Fair",
              "languageCode": "en"
            },
            "containment": "WITHIN"
          },
          {
            "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
            "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
            "displayName": {
              "text": "Central San Jose",
              "languageCode": "en"
            },
            "containment": "WITHIN"
          }
        ]
      }
    },
    /.../
  ]
}

आने वाले समय में खुलने वाले कारोबारों को ढूंढना

यहां इडाहो के न्यू मीडोज़ में, आने वाले समय में खुलने वाले कारोबारों के लिए, टेक्स्ट से खोजें (नया) के अनुरोध का उदाहरण दिया गया है:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.businessStatus,places.openingDate" \
-d '{
  "textQuery": "Roberts Greenhouse and Tree Farm",
  "includeFutureOpeningBusinesses": true,
  "maxResultCount": 20,
  "locationBias": {
    "circle": {
      "center": {"latitude": 44.9755100, "longitude": -116.2842180},
      "radius": 20
    }
  }
}' \
"https://places.googleapis.com/v1/places:searchText"

जवाब में, आने वाले समय में खुलने वाले कारोबारों की जानकारी शामिल होती है. साथ ही, कारोबार की स्थिति और उसके खुलने की संभावित तारीख भी शामिल होती है:

{
  "places": [
    {
      "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
      "businessStatus": "FUTURE_OPENING",
      "displayName": {
        "text": "Roberts Greenhouse and Tree Farm",
        "languageCode": "en"
      },
      "openingDate": {
        "year": 2026,
        "month": 4,
        "day": 15
      }
    }
  ]
}

बस, मेट्रो वगैरह के स्टेशन की जानकारी पाना

बस, मेट्रो वगैरह के स्टेशन ढूंढने के लिए, टेक्स्ट से खोजें (नई) सुविधा का इस्तेमाल किया जा सकता है. रिस्पॉन्स बॉडी में स्टेशन के बारे में जानकारी शामिल होती है. इसमें स्टेशन का नाम, उससे जुड़ी ट्रांसपोर्ट एजेंसियां, और स्टेशन पर सेवा देने वाली बस, मेट्रो वगैरह के रूट मैप शामिल होते हैं. इसके अलावा, जवाब में वाहन का आइकॉन और रंग शामिल होते हैं. इनका इस्तेमाल, बस, मेट्रो वगैरह के स्टेशन की जानकारी दिखाने के लिए किया जा सकता है.

यहां "ग्रैंड सेंट्रल स्टेशन" के लिए किए गए अनुरोध का उदाहरण दिया गया है:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.transitStation" \
-d '{
  "textQuery": "Grand Central Station"
}' \
"https://places.googleapis.com/v1/places:searchText"

जवाब के मुख्य हिस्से में, दायरे में मौजूद हर स्टेशन के बारे में जानकारी शामिल होती है. जैसे, स्टेशन से चलने वाली लाइनें, उस स्टॉप पर ट्रांसपोर्ट एजेंसियों की ओर से जारी की गई सूचनाएं, और रवाना होने की जानकारी:

{
  "places": [
    {
      "id": "ChIJhRwB-yFawokRi0AhGH87UTc",
      "displayName": {
        "text": "Grand Central",
        "languageCode": "en"
      },
      "transitStation": {
        "displayName": {
          "text": "Grand Central",
          "languageCode": "en"
        },
        "agencies": [
          {
            "displayName": {
              "text": "Metro-North Railroad",
              "languageCode": "en"
            },
            "url": "http://www.mta.info/mnr",
            "lines": [
              {
                "id": "ChIJOXpD29y2wokRryDO0CocwK0",
                "vehicleType": "HEAVY_RAIL",
                "displayName": {
                  "text": "Harlem",
                  "languageCode": "en"
                },
                "textColor": "#FFFFFF",
                "backgroundColor": "#0061AA",
                "vehicleIcon": {
                  "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
                },
                "alerts": [
                  {
                    "effect": "OTHER",
                    "texts": [
                      {
                        "headline": {
                          "text": "Information",
                          "languageCode": "en"
                        },
                        "summary": {
                          "text": "Temporary platforms are in place at Botanical Garden, Williams Bridge, and Woodlawn for northbound travel. Build in extra travel time to reach the platform.",
                          "languageCode": "en"
                        },
                        "fullDescription": {
                          "text": "What's Happening? We are renovating some Harlem Line stations in the Bronx. Learn more about the project here.",
                          "languageCode": "en"
                        }
                      }
                    ],
                    "detailsUrls": [
                      {
                        "url": "https://new.mta.info/"
                      }
                    ],
                    "cause": "OTHER_CAUSE",
                    "startTime": "2026-04-16T04:00:00Z",
                    "endTime": "2026-12-01T04:45:00Z",
                    "attribution": {
                      "link": {
                        "text": "new.mta.info",
                        "url": "https://new.mta.info/"
                      }
                    },
                    "createTime": "2026-05-15T22:39:30Z",
                    "severityLevel": "INFO"
                  }
                ]
              },
              ...
            ]
          },
          ...
        ]
        "stops": [
          {
            "id": "ChIJOfdrigFZwokRJPllLwfPrJY",
            "location": {
              "latitude": 40.752823,
              "longitude": -73.977195999999992
            },
            "wheelchairAccessibleEntrance": true
          }
        ],
        "departureBoards": [
          {
            "displayType": "TIME_CENTRIC",
            "rows": [
              {
                "departures": [
                  {
                    "timedDeparture": {
                      "scheduledTime": "2026-05-15T22:42:00Z",
                      "timingType": "SCHEDULED",
                      "predictedTime": "2026-05-15T22:42:00Z",
                      "updateTime": "2026-05-15T22:38:50Z"
                    },
                    "originallyScheduledStopId": "ChIJOfdrigFZwokRJPllLwfPrJY",
                    "lineId": "ChIJAfBuQhwg6IkRYnFpClHxFrM"
                  }
                ]
              },
              ...
            ]
          }
        ]
      }
    },
    {
      "id": "ChIJ_4EAi-pZwokRWe5T1JmmWmc",
      "displayName": {
        "text": "Grand Central Station",
        "languageCode": "en"
      }
    }
  ]
}

किसी जगह के लिए, प्रवेश द्वार और नेविगेशन पॉइंट का अनुरोध किया जा सकता है. किसी जगह के एंट्री और एक्ज़िट पॉइंट को रास्ते कहा जाता है. उदाहरण के लिए, किसी हवाई अड्डे या मॉल के अलग-अलग गेट. नेविगेशन पॉइंट, सड़क के किनारे मौजूद उन जगहों के बारे में बताते हैं जहां नेविगेशन खत्म होना चाहिए. इससे उपयोगकर्ताओं को सड़क के सही किनारे या किसी खास ड्रॉप-ऑफ़ पॉइंट पर ले जाने में मदद मिलती है.

नेविगेशन पॉइंट, navigationPointToken दिखाता है. इस टोकन को Navigation SDK (Android या iOS के लिए उपलब्ध है) या Routes API को पास किया जा सकता है, ताकि ड्राइवर को उस खास जगह पर पहुंचने का रास्ता दिखाया जा सके. ज़्यादा जानकारी के लिए, नेविगेशन पॉइंट टोकन देखें.

नीचे दिए गए उदाहरण में, "सैन फ़्रांसिस्को अंतरराष्ट्रीय हवाई अड्डा" के लिए टेक्स्ट से खोजें (नया) अनुरोध दिखाया गया है. इसमें फ़ील्ड मास्क में entrances और navigationPoints शामिल हैं:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.entrances,places.navigationPoints" \
-d '{
  "textQuery": "San Francisco International Airport",
  "pageSize": 1
}' \
"https://places.googleapis.com/v1/places:searchText"

जवाब में, जगह के एंट्री पॉइंट और नेविगेशन पॉइंट शामिल हैं:

{
  "places": [
    {
      "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "entrances": [
        {
          "location": {
            "latitude": 37.6172154,
            "longitude": -122.3839724
          }
        },
        {
          "location": {
            "latitude": 37.6174073,
            "longitude": -122.384196
          }
        },
        ...
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
          "displayName": {
            "text": "International Terminal Departures Level",
            "languageCode": "en"
          },
          "location": {
            "latitude": 37.6153121,
            "longitude": -122.3900833
          },
          "travelModes": ["WALK"]
        },
        {
          "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
          "displayName": {
            "text": "Domestic Garage - SFO Short Term Parking",
            "languageCode": "en"
          },
          "location": {
            "latitude": 37.6157153,
            "longitude": -122.3885012
          },
          "travelModes": ["DRIVE", "WALK"],
          "usages": ["PARKING"]
        },
        ...
      ]
    }
  ]
}

इसे आज़माएं!

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

पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.
अनुरोध के पैरामीटर में बदलाव करें. हालांकि, ऐसा करना ज़रूरी नहीं है.
Execute बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.
APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें. इससे APIs Explorer विंडो बड़ी हो जाएगी.

परिचय

टेक्स्ट से खोजें (नया) के अनुरोध

टेक्स्ट से खोजें (नया) सुविधा के जवाब

ज़रूरी पैरामीटर

FieldMask

textQuery

ज़रूरी नहीं पैरामीटर

includeFutureOpeningBusinesses

includedType

includePureServiceAreaBusinesses

languageCode

locationBias

locationRestriction

maxResultCount (अब सेवा में नहीं है)

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

pageSize

pageToken

priceLevels

rankPreference

regionCode

strictTypeFiltering

टेक्स्ट से खोज (नई सुविधा) के उदाहरण

क्वेरी स्ट्रिंग की मदद से कोई जगह ढूंढना

कीमत के लेवल के हिसाब से जगहों को फ़िल्टर करना

खोज को किसी तय जगह तक सीमित करना

locationRestriction का इस्तेमाल करके, किसी इलाके को प्रतिबंधित करना

locationBias का इस्तेमाल करके, किसी इलाके को प्राथमिकता देना

कम से कम चार्जिंग रेट वाले ईवी चार्जर खोजना

घर या दुकान पर सेवा देने वाले कारोबारों को खोजना

हर पेज पर दिखाए जाने वाले नतीजों की संख्या तय करना

Address descriptors पाना

आने वाले समय में खुलने वाले कारोबारों को ढूंढना

बस, मेट्रो वगैरह के स्टेशन की जानकारी पाना

एंट्री और नेविगेशन पॉइंट की जानकारी पाना

इसे आज़माएं!