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

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

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

परिचय

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

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

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

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

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

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: *

    इनमें से एक या उससे ज़्यादा फ़ील्ड डालें:

    • इन फ़ील्ड की वजह से, टेक्स्ट से खोजें एसेंशियल आईडी ओनली एसकेयू ट्रिगर होता है:

      places.attributions
      places.id
      places.consumerAlert
      places.name*
      nextPageToken
      places.movedPlace
      places.movedPlaceId

      * places.name फ़ील्ड में, जगह के संसाधन का नाम इस फ़ॉर्मैट में होता है: places/PLACE_ID. जगह के नाम को टेक्स्ट के तौर पर ऐक्सेस करने के लिए, Pro SKU में places.displayName का इस्तेमाल करें.

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड की वजह से, टेक्स्ट से खोजें Pro एसकेयू ट्रिगर होता है:

      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

      * पते की जानकारी देने वाले लैंडमार्क की सुविधा, आम तौर पर भारत में रहने वाले ग्राहकों के लिए उपलब्ध है. अन्य जगहों पर, यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.

      फ़ील्ड और उनसे जुड़े एसकेयू की पूरी सूची देखने के लिए, जगह के लिए डेटा फ़ील्ड (नया) देखें.

    • इन फ़ील्ड की वजह से, टेक्स्ट सर्च एंटरप्राइज़ एसकेयू ट्रिगर होता है:

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

    टेक्स्ट से खोजें (नया) सुविधा का इस्तेमाल, साफ़ तौर पर समझ न आने वाली क्वेरी के लिए नहीं किया जा सकता. इनमें ये क्वेरी शामिल हैं:

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

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

  • includeFutureOpeningBusinesses

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

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

  • includedType

    यह टेबल A में तय किए गए टाइप से मैच करने वाली जगहों के हिसाब से नतीजे दिखाता है. सिर्फ़ एक टाइप चुना जा सकता है. उदाहरण के लिए:

    • "includedType":"bar"
    • "includedType":"pharmacy"

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

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

  • includePureServiceAreaBusinesses

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

  • 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 शामिल होता है. इसे अगले पेज को ऐक्सेस करने के लिए, बाद के अनुरोध में पास किया जा सकता है.

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

  • pageToken

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

  • priceLevels

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

    इन जगहों के लिए, कीमत के लेवल की जानकारी मिल सकती है:

    अगर priceLevels की वैल्यू दी गई है, तो जवाब में ऐसी जगहों को शामिल नहीं किया जाएगा जो काम नहीं करती हैं.

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

    उदाहरण के लिए:

    "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

  • rankPreference

    इससे यह तय होता है कि क्वेरी के टाइप के आधार पर, जवाब में नतीजों को किस तरह रैंक किया जाएगा:

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

  • regionCode

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

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

    ज़्यादातर सीएलडीआर कोड, आईएसओ 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका आईएसओ 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"
      }
    },
    ...
  ]
}

ज़्यादा जानकारी पाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें. उदाहरण के लिए, जवाब में रेस्टोरेंट का टाइप और वेब पता शामिल करने के लिए, 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 का इस्तेमाल करके, इलाके पर पाबंदी लगाना

क्वेरी के नतीजों को किसी खास इलाके तक सीमित करने के लिए, 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"
          },
          ...
        ]
      }
    },
    {
      "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"
          }
        ]
      }
    },
    ...
  ]
}

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

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"
      }
    },
    {
      "displayName": {
        "text": "Starboy Plumbing Inc.",
        "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"
    },
    ...
  ],
  "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"
    },
    ...
  ],
  "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
          },
          ...
        ],
        "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"
          },
          ...
        ]
      }
    },
    ...
  ]
}

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

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

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 की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और उसके विकल्पों के बारे में जानकारी मिलती है.

  1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api को चुनें.

  2. अनुरोध के पैरामीटर में बदलाव करें. हालांकि, ऐसा करना ज़रूरी नहीं है.

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

  4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें. इससे APIs Explorer की विंडो बड़ी हो जाएगी.