आस-पास की जगहों की जानकारी (नया)

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा
यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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

आस-पास की जगहों की जानकारी (नई सुविधा) के नतीजों को मैप पर देखने के लिए, इंटरैक्टिव डेमो आज़माएं.

आस-पास की जगहों की जानकारी (नई सुविधा) के अनुरोध

आस-पास की जगहों की जानकारी (नई सुविधा) का अनुरोध, इस फ़ॉर्मैट में मौजूद यूआरएल के लिए एचटीटीपी POST अनुरोध होता है:

https://places.googleapis.com/v1/places:searchNearby

POST अनुरोध के हिस्से के तौर पर, JSON अनुरोध के मुख्य हिस्से या हेडर में सभी पैरामीटर पास करें. उदाहरण के लिए:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "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" \
https://places.googleapis.com/v1/places:searchNearby

आस-पास की जगहों की जानकारी (नई सुविधा) के जवाब

आस-पास की जगहों की जानकारी (नई सुविधा) के जवाब के तौर पर, 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: *

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

    • इन फ़ील्ड से, आस-पास की जगहों की जानकारी Search Pro SKU ट्रिगर होता है:

      places.accessibilityOptions
      places.addressComponents
      places.addressDescriptor*
      places.adrFormatAddress
      places.attributions
      places.businessStatus
      places.containingPlaces
      places.displayName
      places.formattedAddress
      places.googleMapsLinks
      places.googleMapsUri
      places.iconBackgroundColor
      places.iconMaskBaseUri
      places.id
      places.location
      places.name**
      places.movedPlace
      places.movedPlaceId
      places.openingDate
      places.photos
      places.plusCode
      places.postalAddress
      places.primaryType
      places.primaryTypeDisplayName
      places.pureServiceAreaBusiness
      places.shortFormattedAddress
      places.subDestinations
      places.timeZone
      places.types
      places.utcOffsetMinutes
      places.viewport

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

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

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

    • इन फ़ील्ड से, आस-पास की जगहों की जानकारी 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

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

    • इन फ़ील्ड से, आस-पास की जगहों की जानकारी 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

      * सिर्फ़ टेक्स्ट से खोजें और आस-पास की जगहों की जानकारी के लिए

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

  • locationRestriction

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

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

    "locationRestriction": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}

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

  • includeFutureOpeningBusinesses

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

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

  • includedTypes/excludedTypes, includedPrimaryTypes/excludedPrimaryTypes

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

    किसी जगह से, टाइप की टेबल A का सिर्फ़ एक प्राइमरी टाइप जोड़ा जा सकता है. उदाहरण के लिए, प्राइमरी टाइप "mexican_restaurant" या "steak_house" हो सकता है. किसी जगह के प्राइमरी टाइप के आधार पर नतीजों को फ़िल्टर करने के लिए, includedPrimaryTypes और excludedPrimaryTypes का इस्तेमाल करें.

    किसी जगह से, टाइप की टेबल A की एक से ज़्यादा टाइप वैल्यू भी जोड़ी जा सकती हैं. उदाहरण के लिए, किसी रेस्टोरेंट के ये टाइप हो सकते हैं: "seafood_restaurant", "restaurant", "food", "point_of_interest", "establishment". किसी जगह से जुड़े टाइप की सूची के आधार पर नतीजों को फ़िल्टर करने के लिए, includedTypes और excludedTypes का इस्तेमाल करें.

    जब कोई सामान्य प्राइमरी टाइप तय किया जाता है, जैसे कि "restaurant" या "hotel", तो जवाब में ऐसी जगहें शामिल हो सकती हैं जिनका प्राइमरी टाइप, तय किए गए प्राइमरी टाइप से ज़्यादा खास हो. उदाहरण के लिए, आपने प्राइमरी टाइप को शामिल करने के लिए तय किया है "restaurant". इसके बाद, जवाब में ऐसे प्राइमरी टाइप "restaurant" वाली जगहें शामिल हो सकती हैं जो ज़्यादा खास हैं. जैसे, "chinese_restaurant" या "seafood_restaurant".

    अगर खोज के लिए, टाइप से जुड़ी एक से ज़्यादा पाबंदियां तय की जाती हैं, तो सिर्फ़ वे जगहें दिखाई जाती हैं जो सभी पाबंदियों को पूरा करती हैं. उदाहरण के लिए, अगर आपने {"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]} तय किया है, तो दिखाई गई जगहों पर "restaurant" से जुड़ी सेवाएं मिलती हैं. हालांकि, ये जगहें मुख्य तौर पर "steak_house" के तौर पर काम नहीं करती हैं.

    includedTypes

    खोज के लिए, टेबल A में मौजूद जगह के टाइप की कॉमा लगाकर अलग की गई लिस्ट. अगर इस पैरामीटर को छोड़ दिया जाता है, तो सभी टाइप की जगहें दिखाई जाती हैं.

    excludedTypes

    खोज से बाहर रखने के लिए, टेबल A में मौजूद जगह के टाइप की कॉमा लगाकर अलग की गई लिस्ट.

    अगर अनुरोध में includedTypes ( जैसे, "school") और excludedTypes (जैसे, "primary_school") दोनों तय किए जाते हैं, तो जवाब में वे जगहें शामिल होती हैं जिन्हें "school" के तौर पर कैटगरी में रखा गया है, लेकिन "primary_school" के तौर पर नहीं. जवाब में वे जगहें शामिल होती हैं जो कम से कम एक से मेल खाती हैंincludedTypes और किसी भी से मेल नहीं खाती हैंexcludedTypes.

    अगर टाइप में कोई टकराव होता है, जैसे कि कोई टाइप includedTypes और excludedTypes दोनों में दिखता है, तो INVALID_REQUEST गड़बड़ी दिखती है.

    includedPrimaryTypes

    खोज में शामिल करने के लिए, टेबल A में मौजूद प्राइमरी जगह के टाइप की कॉमा लगाकर अलग की गई लिस्ट.

    excludedPrimaryTypes

    खोज से बाहर रखने के लिए, टेबल A में मौजूद प्राइमरी टाइप की कॉमा लगाकर अलग की गई लिस्ट.

    अगर प्राइमरी टाइप में कोई टकराव होता है, जैसे कि कोई टाइप includedPrimaryTypes और excludedPrimaryTypes दोनों में दिखता है, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

  • languageCode

    वह भाषा जिसमें नतीजे दिखाने हैं.

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

  • maxResultCount

    इससे, जगह के नतीजों की ज़्यादा से ज़्यादा संख्या तय की जाती है. यह 1 से 20 (डिफ़ॉल्ट) के बीच होना चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं.

  • rankPreference

    रैंक करने के लिए इस्तेमाल किया जाने वाला टाइप. अगर इस पैरामीटर को छोड़ दिया जाता है, तो नतीजों को लोकप्रियता के हिसाब से रैंक किया जाता है. यह इनमें से कोई एक हो सकता है:

    • POPULARITY (डिफ़ॉल्ट) नतीजों को उनकी लोकप्रियता के हिसाब से क्रम में लगाता है.
    • DISTANCE नतीजों को तय की गई जगह से उनकी दूरी के हिसाब से, बढ़ते क्रम में क्रम में लगाता है.

  • regionCode

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

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

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

आस-पास की जगहों की जानकारी (नई सुविधा) के उदाहरण

एक टाइप की जगहें ढूंढना

यहां आस-पास की जगहों की जानकारी (नई सुविधा) के अनुरोध का एक उदाहरण दिया गया है. इसमें, circle से तय किए गए 500 मीटर के दायरे में मौजूद सभी रेस्टोरेंट के डिसप्ले नेम दिखाए गए हैं: 

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "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" \
https://places.googleapis.com/v1/places:searchNearby

ध्यान दें कि X-Goog-FieldMask हेडर से यह तय होता है कि जवाब में ये डेटा फ़ील्ड शामिल हैं: places.displayName. इसके बाद, जवाब इस फ़ॉर्मैट में होता है:

{
  "places": [
    {
      "displayName": {
        "text": "La Mar Cocina Peruana",
        "languageCode": "en"
      }
    },
    {
      "displayName": {
        "text": "Kokkari Estiatorio",
        "languageCode": "en"
      }
    },
    {
      "displayName": {
        "text": "Harborview Restaurant & Bar",
        "languageCode": "en"
      }
    },
...
}

ज़्यादा जानकारी पाने के लिए, फ़ील्ड मास्क में ज़्यादा डेटा टाइप जोड़ें. उदाहरण के लिए, जवाब में रेस्टोरेंट का पता, टाइप, और वेब पता शामिल करने के लिए, places.formattedAddress,places.types,places.websiteUri जोड़ें:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "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,places.types,places.websiteUri" \
https://places.googleapis.com/v1/places:searchNearby

अब जवाब इस फ़ॉर्मैट में है:

{
  "places": [
    {
      "types": [
        "seafood_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "PIER 1 1/2 The Embarcadero N, San Francisco, CA 94105, USA",
      "websiteUri": "http://lamarsf.com/",
      "displayName": {
        "text": "La Mar Cocina Peruana",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "greek_restaurant",
        "meal_takeaway",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "200 Jackson St, San Francisco, CA 94111, USA",
      "websiteUri": "https://kokkari.com/",
      "displayName": {
        "text": "Kokkari Estiatorio",
        "languageCode": "en"
      }
    },
...
}

एक से ज़्यादा टाइप की जगहें ढूंढना

यहां आस-पास की जगहों की जानकारी (नई सुविधा) के अनुरोध का एक उदाहरण दिया गया है. इसमें, तय किए गए circle के 1,000 मीटर के दायरे में मौजूद सभी किराने की दुकान : शॉपिंग स्टोर (As per context) और शराब की दुकानों के डिसप्ले नेम दिखाए गए हैं:

curl -X POST -d '{
  "includedTypes": ["liquor_store", "convenience_store"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 1000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.primaryType,places.types" \
https://places.googleapis.com/v1/places:searchNearby
इस उदाहरण में, फ़ील्ड मास्क में places.primaryType और places.types जोड़े गए हैं, ताकि जवाब में हर जगह के टाइप की जानकारी शामिल हो. इससे, नतीजों में से सही जगह चुनना आसान हो जाता है.

यहां आस-पास की जगहों की जानकारी (नई सुविधा) के अनुरोध का एक उदाहरण दिया गया है. इसमें, "school" टाइप की सभी जगहें दिखाई गई हैं. हालांकि, "primary_school" टाइप की सभी जगहों को बाहर रखा गया है. साथ ही, नतीजों को दूरी के हिसाब से रैंक किया गया है:

curl -X POST -d '{
  "includedTypes": ["school"],
  "excludedTypes": ["primary_school"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 1000.0
    }
  },
  "rankPreference": "DISTANCE"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby

किसी इलाके के आस-पास की सभी जगहें खोजना और उन्हें दूरी के हिसाब से रैंक करना

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

curl -X POST -d '{
  "maxResultCount": 10,
  "rankPreference": "DISTANCE",
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965
      },
      "radius": 1000.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName" \
https://places.googleapis.com/v1/places:searchNearby

पते के बारे में खास जानकारी पाना

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

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

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.321328,
        "longitude": -121.946275
      },"radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
}' \
-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:searchNearby

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

  {
    "places": [
      {
        "displayName": {
          "text": "Westfield Valley Fair",
          "languageCode": "en"
        },
        "addressDescriptor": {
          "landmarks": [
            {
              "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": 114.76984,
              "travelDistanceMeters": 114.261856
            },
            {
              "name": "places/ChIJgexMlR_Lj4ARiKCKuhNnjn0",
              "placeId": "ChIJgexMlR_Lj4ARiKCKuhNnjn0",
              "displayName": {
                "text": "Valley Fair Mall Eyexam of CA",
                "languageCode": "en"
              },
              "types": [
                "establishment",
                "health",
                "point_of_interest"
              ],
              "straightLineDistanceMeters": 131.62566,
              "travelDistanceMeters": 237.33253
            },
            {
              "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
              "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
              "displayName": {
                "text": "Din Tai Fung",
                "languageCode": "en"
              },
              "types": [
                "establishment",
                "food",
                "point_of_interest",
                "restaurant"
              ],
              "straightLineDistanceMeters": 110.0775,
              "travelDistanceMeters": 171.41951
            },
            {
              "name": "places/ChIJwyfPQx7Lj4AR7bYI2A2Yc54",
              "placeId": "ChIJwyfPQx7Lj4AR7bYI2A2Yc54",
              "displayName": {
                "text": "Abercrombie & Fitch",
                "languageCode": "en"
              },
              "types": [
                "clothing_store",
                "establishment",
                "point_of_interest",
                "shoe_store",
                "store"
              ],
              "spatialRelationship": "DOWN_THE_ROAD",
              "straightLineDistanceMeters": 53.620117,
              "travelDistanceMeters": 2.4578214
            },
            {
              "name": "places/ChIJpycNQx7Lj4ARjhXw3PrM_kU",
              "placeId": "ChIJpycNQx7Lj4ARjhXw3PrM_kU",
              "displayName": {
                "text": "Hollister Co.",
                "languageCode": "en"
              },
              "types": [
                "clothing_store",
                "establishment",
                "point_of_interest",
                "shoe_store",
                "store"
              ],
              "spatialRelationship": "DOWN_THE_ROAD",
              "straightLineDistanceMeters": 56.53726,
              "travelDistanceMeters": 15.418246
            }
          ],
          "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": "OUTSKIRTS"
            }
          ]
        }
      },
  /.../
  }

आने वाले दिनों में खुलने वाले कारोबारों की जानकारी पाना

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

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 '{
  "includeFutureOpeningBusinesses": true,
  "maxResultCount": 20,
  "locationRestriction": {
    "circle": {
      "center": {"latitude": 44.9755100, "longitude": -116.2842180},
      "radius": 20
    }
  },
  "rankPreference": "DISTANCE"
}' \
"https://places.googleapis.com/v1/places:searchNearby"

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

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

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

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

यहां मिडटाउन मैनहटन के 50 मीटर के दायरे में मौजूद ट्रांज़िट स्टेशनों के अनुरोध का एक उदाहरण दिया गया है:

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 '{
  "includedTypes": ["transit_station"],
  "locationRestriction": {
    "circle": {
      "center": {"latitude": 40.754851, "longitude": -73.984164},
      "radius": 50.0
    }
  }
}' \
"https://places.googleapis.com/v1/places:searchNearby"

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

{
  "places": [
    {
      "id": "ChIJH2EstKpZwokRCwZtYyMd5Fg",
      "displayName": {
        "text": "6 Av/W 41 St",
        "languageCode": "en"
      },
      "transitStation": {
        "displayName": {
          "text": "6 Av/W 41 St",
          "languageCode": "en"
        },
        "agencies": [
          {
            "displayName": {
              "text": "ShortLine Hudson",
              "languageCode": "en"
            },
            "url": "https://www.coachusa.com/",
            "lines": [
              {
                "id": "ChIJSQlbzvPwwokRolrIA-Kuh6o",
                "vehicleType": "BUS",
                "displayName": {
                  "text": "200 - Northern District – Nanuet",
                  "languageCode": "en"
                },
                "shortDisplayName": {
                  "text": "ShortLine Hudson",
                  "languageCode": "en"
                },
                "textColor": "#000000",
                "backgroundColor": "#ED60A3",
                "vehicleIcon": {
                  "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
                }
              }
            ]
          },
          {
            "displayName": {
              "text": "MTA New York City Transit",
              "languageCode": "en"
            },
            "url": "http://www.mta.info/",
            "lines": [
              {
                "id": "ChIJjUrj7PBewokR3O3S2JVpBrI",
                "vehicleType": "SUBWAY",
                "displayName": {
                  "text": "E Train (8 Av Local)",
                  "languageCode": "en"
                },
                "shortDisplayName": {
                  "text": "E Line",
                  "languageCode": "en"
                },
                "textColor": "#FFFFFF",
                "backgroundColor": "#0039A6",
                "url": "https://www.mta.info/schedules/subway/e-train",
                "icon": {
                  "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/E.svg",
                  "nameIncluded": true
                },
                "vehicleIcon": {
                  "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
                }
              },
              ...
            ]
          },
        "stops": [
          {
            "id": "ChIJvRnquapZwokRdUOyVwNGbe8",
            "displayName": {
              "text": "6 Av/W 41 St",
              "languageCode": "en"
            },
            "location": {
              "latitude": 40.754509,
              "longitude": -73.984216500000016
            },
            "wheelchairAccessibleEntrance": true
          }
        ],
        "departureBoards": [
          {
            "displayType": "DIRECTION_CENTRIC",
            "rows": [
              {
                "departures": [
                  {
                    "timedDeparture": {
                      "scheduledTime": "2026-05-15T22:29:51Z",
                      "timingType": "SCHEDULED"
                    },
                    "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8",
                    "lineId": "ChIJA1aFyaZfwokRkO5869M6UXk"
                  }
                ]
              },
              {
                "departures": [
                  {
                    "timedDeparture": {
                      "scheduledTime": "2026-05-15T22:33:55Z",
                      "timingType": "SCHEDULED"
                    },
                    "originallyScheduledStopId": "ChIJvRnquapZwokRdUOyVwNGbe8",
                    "lineId": "ChIJj3iCEwJfwokRZE2Qtnm4pPI"
                  }
                ]
              },
              ...
            ]
          }
        ]
      }
    },
    ...
    {
      {
        "id": "ChIJPyq6TZBZwokRdGoiJ5Iq_hE",
        "vehicleType": "BUS",
        "displayName": {
          "text": "W 44 St - South Ferry",
          "languageCode": "en"
        },
        "shortDisplayName": {
          "text": "M55",
          "languageCode": "en"
        },
        "textColor": "#FFFFFF",
        "backgroundColor": "#1D59B3",
        "vehicleIcon": {
          "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
        },
        "alerts": [
          {
            "effect": "OTHER",
            "texts": [
              {
                "headline": {
                  "text": "Information",
                  "languageCode": "en"
                },
                "summary": {
                  "text": "Northbound M20 and M55 stop on State St at Bridge St is closed; use the temporary stop on State St before the intersection instead",
                  "languageCode": "en"
                },
                "fullDescription": {
                  "text": "See a map of the new stop location. What's happening? Construction",
                  "languageCode": "en"
                }
              }
            ],
            "detailsUrls": [
              {
                "url": "https://www.mta.info/"
              }
            ],
            "cause": "OTHER_CAUSE",
            "startTime": "2025-04-02T04:00:00Z",
            "endTime": "2026-06-15T00:00:00Z",
            "attribution": {
              "link": {
                "text": "www.mta.info",
                "url": "https://www.mta.info/"
              }
            },
            "createTime": "2026-05-15T22:32:00Z",
            "severityLevel": "INFO"
          }
        ]
      },
      ...
    }
    ...
  }

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

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

नेविगेशन पॉइंट, 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 '{
  "includedTypes": ["airport"],
  "maxResultCount": 1,
  "locationRestriction": {
    "circle": {
      "center": {"latitude": 37.6193, "longitude": -122.3816},
      "radius": 1000.0
    }
  }
}' \
"https://places.googleapis.com/v1/places:searchNearby"

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

{
  "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 पैनल में, APIs Explorer विंडो को बड़ा करने के लिए, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें.