परिचय
टेक्स्ट खोज (नई सुविधा) किसी स्ट्रिंग के आधार पर, जगहों के सेट के बारे में जानकारी देती है. उदाहरण के लिए, "दिल्ली में पिज़्ज़ा" या "ओटावा के आस-पास जूते की दुकानें" या "123 मेन स्ट्रीट". इसके बाद, सेवा टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से, जगहों की सूची दिखाती है.
ज़रूरी पैरामीटर के अलावा, टेक्स्ट खोज (नया वर्शन) में बेहतर नतीजे पाने के लिए, वैकल्पिक पैरामीटर का इस्तेमाल करके क्वेरी को बेहतर बनाया जा सकता है.
एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:
टेक्स्ट सर्च (नई सुविधा) के अनुरोध
टेक्स्ट सर्च (नई) सुविधा के लिए किया गया अनुरोध, इस तरह का एचटीटीपी POST अनुरोध होता है:
https://places.googleapis.com/v1/places:searchText
सभी पैरामीटर को JSON अनुरोध के मुख्य हिस्से में या हेडर में, POST अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:
curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,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: * इनमें से एक या उससे ज़्यादा फ़ील्ड डालें: - इन फ़ील्ड से सिर्फ़ आईडी वाले SKU के लिए टेक्स्ट खोज की ज़रूरी शर्तें ट्रिगर होती हैं: - places.attributions
 - places.id
 - places.name*
 - nextPageToken
 - places.movedPlace
 - places.movedPlaceId- * - places.nameफ़ील्ड में जगह का संसाधन का नाम होता है. यह इस फ़ॉर्म में होता है:- places/PLACE_ID. जगह के नाम को टेक्स्ट के तौर पर ऐक्सेस करने के लिए, Pro SKU में- places.displayNameका इस्तेमाल करें.
- इन फ़ील्ड से Text Search Pro SKU ट्रिगर होता है: - places.accessibilityOptions
 - places.addressComponents
 - places.addressDescriptor*
 - places.adrFormatAddress
 - places.businessStatus
 - places.containingPlaces
 - places.displayName
 - places.formattedAddress
 - places.googleMapsLinks
 - places.googleMapsUri
 - places.iconBackgroundColor
 - places.iconMaskBaseUri
 - places.location
 - places.photos
 - places.plusCode
 - places.postalAddress
 - places.primaryType
 - places.primaryTypeDisplayName
 - places.pureServiceAreaBusiness
 - places.shortFormattedAddress
 - places.searchUri
 - places.subDestinations
 - places.types
 - places.utcOffsetMinutes
 - places.viewport
 * पता बताने वाले शब्दों की सुविधा, भारत में रहने वाले खरीदारों के लिए आम तौर पर उपलब्ध है. हालांकि, अन्य देशों में यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.
 
- इन फ़ील्ड से Text Search Enterprise SKU ट्रिगर होता है: - places.currentOpeningHours
 - places.currentSecondaryOpeningHours
 - places.internationalPhoneNumber
 - places.nationalPhoneNumber
 - places.priceLevel
 - places.priceRange
 - places.rating
 - places.regularOpeningHours
 - places.regularSecondaryOpeningHours
 - places.userRatingCount
 - places.websiteUri
- इन फ़ील्ड से Text Search Enterprise + Atmosphere SKU ट्रिगर होता है: - 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"कारोबार, चेन या कैटगरी के नाम के साथ उन जगहों के नाम जहां ये उपलब्ध नहीं हैं "डैलस, टेक्सस के पास मौजूद टेस्को स्टोर" एक से ज़्यादा मतलब वाली क्वेरी "चार्जर को ड्रॉप-ऑफ़ करना" इतिहास में शामिल ऐसे नाम जिनका अब इस्तेमाल नहीं किया जा रहा है "Middlesex United Kingdom" जियोस्पेशल जानकारी न होना या जियोस्पेशल जानकारी के बारे में न बताना "वेंचुरा हार्बर में कितनी नावें हैं?" गैर-आधिकारिक या बनावटी नाम "द जेंगा" 
 "द हेल्टर स्केल्टर"अक्षांश और देशांतर निर्देशांक "37.422131,-122.084801" 
ज़रूरी नहीं पैरामीटर
- includedType- नतीजों को टेबल A में तय किए गए टाइप से मेल खाने वाली जगहों के हिसाब से दिखाता है. सिर्फ़ एक टाइप तय किया जा सकता है. उदाहरण के लिए: - "includedType":"bar"
- "includedType":"pharmacy"
 - टेक्स्ट खोज (नई सुविधा) में, कुछ क्वेरी के लिए टाइप फ़िल्टरिंग लागू होती है. यह इस बात पर निर्भर करती है कि यह सुविधा लागू हो सकती है या नहीं. उदाहरण के लिए, हो सकता है कि टाइप फ़िल्टर करने की सुविधा, किसी खास पते ("123 मेन स्ट्रीट") के लिए की गई क्वेरी पर लागू न हो. हालांकि, यह सुविधा कैटगरी के हिसाब से की गई क्वेरी ("आस-पास की दुकानें" या "शॉपिंग मॉल") पर लगभग हमेशा लागू होती है. - सभी क्वेरी पर टाइप फ़िल्टरिंग लागू करने के लिए, - strictTypeFilteringको- trueपर सेट करें.
- 
    includePureServiceAreaBusinessestrueपर सेट होने पर, जवाब में ऐसे कारोबार शामिल होते हैं जो ग्राहकों को सीधे तौर पर सेवाएं देते हैं या उनसे संपर्क करते हैं. हालांकि, उनके पास कोई ऐसी जगह नहीं होती जहां ग्राहक पहुंच सकें. अगर इसेfalseपर सेट किया जाता है, तो एपीआई सिर्फ़ उन कारोबारों की जानकारी दिखाता है जिनकी कोई तय जगह हो.
- languageCode- वह भाषा जिसमें नतीजे दिखाने हैं. - इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. Google, इस सुविधा के लिए उपलब्ध भाषाओं को अक्सर अपडेट करता रहता है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
- 
        अगर languageCodeनहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप सेenपर सेट हो जाता है. अगर आपने अमान्य भाषा कोड डाला है, तो एपीआईINVALID_ARGUMENTगड़बड़ी का मैसेज दिखाता है.
- एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को पूरा करने के लिए, यह स्थानीय भाषा में सड़क के पते दिखाता है. अगर ज़रूरी हो, तो यह पते को ऐसी स्क्रिप्ट में लिप्यंतरित करता है जिसे उपयोगकर्ता पढ़ सकता है. ऐसा करते समय, यह उपयोगकर्ता की पसंदीदा भाषा का ध्यान रखता है. अन्य सभी पते, चुनी गई भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट, एक ही भाषा में दिखाए जाते हैं. यह भाषा, पहले कॉम्पोनेंट से चुनी जाती है.
- अगर नाम आपकी पसंदीदा भाषा में उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिले नतीजों के सेट और उनके क्रम पर पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए गए शॉर्ट फ़ॉर्म या ऐसे समानार्थी शब्द जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं.
 
- 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को उस क्षेत्र के तौर पर समझें जहां नतीजे होने की संभावना है. हालांकि, नतीजे इस क्षेत्र के बाहर भी हो सकते हैं.
- 
    maxResultCount (अब सेवा में नहीं है)इससे हर पेज पर दिखाए जाने वाले नतीजों की संख्या (1 से 20 के बीच) तय की जाती है. उदाहरण के लिए, maxResultCountकी वैल्यू 5 सेट करने पर, पहले पेज पर ज़्यादा से ज़्यादा पांच नतीजे दिखेंगे. अगर क्वेरी के लिए और नतीजे उपलब्ध हैं, तो जवाब में एकnextPageTokenशामिल होता है. इसे अगले पेज को ऐक्सेस करने के लिए, बाद के अनुरोध में पास किया जा सकता है.
- 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 की वैल्यू से, एक से कम रेटिंग वाले सभी नतीजे हट जाते हैं. 
- openNow- अगर - true, तो सिर्फ़ उन जगहों की जानकारी दिखाओ जो क्वेरी भेजे जाने के समय कारोबार के लिए खुली हों. अगर- falseहै, तो खुले होने के स्टेटस के बावजूद सभी कारोबारों की जानकारी दिखाएं. अगर आपने इस पैरामीटर को- falseपर सेट किया है, तो उन जगहों के नतीजे दिखाए जाते हैं जिनके खुलने का समय Google Places डेटाबेस में नहीं दिया गया है.
- pageSize- इससे हर पेज पर दिखाए जाने वाले नतीजों की संख्या (1 से 20 के बीच) तय की जाती है. उदाहरण के लिए, - pageSizeकी वैल्यू 5 सेट करने पर, पहले पेज पर ज़्यादा से ज़्यादा पांच नतीजे दिखेंगे. अगर क्वेरी के लिए और नतीजे उपलब्ध हैं, तो जवाब में एक- nextPageTokenशामिल होता है. इसे अगले पेज को ऐक्सेस करने के लिए, बाद के अनुरोध में पास किया जा सकता है.
- pageToken- यह पिछले पेज के जवाब के मुख्य हिस्से से - nextPageTokenकी जानकारी देता है.
- 
    priceLevelsखोज के नतीजों को उन जगहों तक सीमित करें जिनकी कीमत तय की गई है. डिफ़ॉल्ट रूप से, सभी प्राइस लेवल चुने जाते हैं. इन जगहों के लिए, कीमत के लेवल की जानकारी मिल सकती है: अगर 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 "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 हेडर से पता चलता है कि response में ये डेटा फ़ील्ड शामिल हैं: 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 डेटा फ़ील्ड को response में जोड़ा गया है, ताकि यह इस फ़ॉर्म में हो:
{ "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 का इस्तेमाल करके, इलाके के हिसाब से पाबंदी लगाना
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" }
नतीजों के अगले पेज को ऐक्सेस करने के लिए, अनुरोध के मुख्य हिस्से में 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" }
Address descriptors पाना
पते के बारे में बताने वाले शब्दों से, किसी जगह की लोकेशन के बारे में जानकारी मिलती है. इसमें आस-पास के लैंडमार्क और इलाके शामिल हैं.
नीचे दिए गए उदाहरण में, दिल्ली के एक मॉल के आस-पास की जगहों के लिए, टेक्स्ट सर्च (नया) अनुरोध दिखाया गया है. इस उदाहरण में, फ़ील्ड मास्क में 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" } ] } }, /.../ ] }
इसे आज़माएं!
APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
- पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें. 
- अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है. 
- लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है. 
- APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.