जगह की जानकारी (नई)

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

परिचय

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

जगह का आईडी पाने के कई तरीके हैं. आप इसका उपयोग कर सकते हैं:

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

Place Details (New) के अनुरोध

जगह के बारे में ज़्यादा जानकारी (नया) का अनुरोध, इस तरह का एचटीटीपी GET अनुरोध होता है:

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

सभी पैरामीटर को यूआरएल पैरामीटर के तौर पर या हेडर में जीईटी अनुरोध के हिस्से के तौर पर पास करें. उदाहरण के लिए:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

या कर्ल कमांड में:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

जगह की जानकारी (नई) के जवाब

जगह के बारे में ज़्यादा जानकारी (नया) के अनुरोध पर, JSON ऑब्जेक्ट के तौर पर रिस्पॉन्स मिलता है. जवाब में:

  • जवाब को Place ऑब्जेक्ट के तौर पर दिखाया जाता है. Place ऑब्जेक्ट में, जगह के बारे में ज़्यादा जानकारी होती है.
  • अनुरोध में पास किया गया FieldMask, Place ऑब्जेक्ट में दिखाए गए फ़ील्ड की सूची तय करता है.

पूरा JSON ऑब्जेक्ट इस फ़ॉर्म में होता है:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

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

  • FieldMask

    जवाब फ़ील्ड मास्क बनाकर, जवाब में दिखाए जाने वाले फ़ील्ड की सूची तय करें. यूआरएल पैरामीटर $fields या fields का इस्तेमाल करके, रिस्पॉन्स फ़ील्ड मास्क को तरीके से पास करें. इसके अलावा, एचटीटीपी हेडर X-Goog-FieldMask का इस्तेमाल करके भी ऐसा किया जा सकता है. जवाब में, लौटाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. फ़ील्ड मास्क शामिल न करने पर, यह तरीका गड़बड़ी का मैसेज दिखाता है.

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

    जगह के डेटा टाइप की कॉमा लगाकर अलग की गई लिस्ट दें, ताकि उन्हें दिखाया जा सके. उदाहरण के लिए, जगह का डिसप्ले नेम और पता वापस पाने के लिए.

    X-Goog-FieldMask: displayName,formattedAddress

    सभी फ़ील्ड वापस पाने के लिए, * का इस्तेमाल करें.

    X-Goog-FieldMask: *

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

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

      attributions
      consumerAlert
      id
      movedPlace
      movedPlaceId
      name*
      photos

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

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

    • इन फ़ील्ड से, Place Details Essentials SKU ट्रिगर होता है:

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

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

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

    • इन फ़ील्ड से, Place Details Pro SKU ट्रिगर होता है:

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsTypeLabel
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

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

    • इन फ़ील्ड से, जगह के बारे में ज़्यादा जानकारी देने वाला Enterprise SKU ट्रिगर होता है:

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      transitStation
      userRatingCount
      websiteUri

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

    • इन फ़ील्ड से, Place Details Enterprise + Atmosphere SKU ट्रिगर होता है:

      allowsDogs
      curbsidePickup
      delivery
      dineIn
      editorialSummary
      evChargeAmenitySummary
      evChargeOptions
      fuelOptions
      generativeSummary
      goodForChildren
      goodForGroups
      goodForWatchingSports
      liveMusic
      menuForChildren
      neighborhoodSummary
      parkingOptions
      paymentOptions
      outdoorSeating
      reservable
      restroom
      reviews
      reviewSummary
      routingSummaries*
      servesBeer
      servesBreakfast
      servesBrunch
      servesCocktails
      servesCoffee
      servesDessert
      servesDinner
      servesLunch
      servesVegetarianFood
      servesWine
      takeout

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

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

  • placeId

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

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

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

  • languageCode

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

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

  • regionCode

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

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

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

  • sessionToken

    सेशन टोकन, उपयोगकर्ता की ओर से जनरेट की गई ऐसी स्ट्रिंग होती हैं जो ऑटोकंप्लीट (नया) कॉल को "सेशन" के तौर पर ट्रैक करती हैं. 'अपने-आप पूरा होने की सुविधा (नया वर्शन)' सेशन टोकन का इस्तेमाल करती है. इससे, बिलिंग के मकसद से, उपयोगकर्ता की खोज क्वेरी और खोज के अपने-आप पूरे होने की सुविधा के तहत, क्वेरी और जगह चुनने के चरणों को अलग-अलग सेशन में ग्रुप किया जाता है. सेशन टोकन, Place Details (New) कॉल में पास किए जाते हैं. ये कॉल, Autocomplete (New) कॉल के बाद किए जाते हैं. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.

Place Details (नई) का उदाहरण

यहां दिए गए उदाहरण में, placeId के ज़रिए किसी जगह की जानकारी का अनुरोध किया गया है:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

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

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

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

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

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

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Address descriptors पाना

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

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

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

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

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "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": 220.29175
        },
        {
          "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": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "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"
        }
      ]
    }
  }

किसी जगह की जानकारी पाना

अगर आपके ऐप्लिकेशन में बताई गई किसी जगह को दूसरी जगह पर ले जाया गया है, तो नई जगह की जानकारी पाने के लिए, movedPlace और movedPlaceId फ़ील्ड का इस्तेमाल करें.

हमेशा के लिए बंद हो गया है जगहों के लिए, Place Details (New) API, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, जवाब के मुख्य हिस्से में movedPlace और movedPlaceId फ़ील्ड को शामिल नहीं करता है.

जिन जगहों के लिए पता बदल गया है, उनके लिए Place Details (New) API, businessStatus फ़ील्ड में CLOSED_PERMANENTLY दिखाता है. साथ ही, जवाब के मुख्य हिस्से के movedPlace और movedPlaceId फ़ील्ड में नई जगह की जानकारी दिखाता है.

जिन जगहों की जानकारी नहीं बदली है उनके लिए, Place Details (New) के जवाब में movedPlace या movedPlaceId नहीं मिलता है.

यहां दिए गए उदाहरण में, कनाडा के क्यूबेक में मौजूद Marche IGA St-Canut के बारे में जानकारी का अनुरोध किया गया है:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

अनुरोध करने पर, यह जवाब मिलता है:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

नई जगह के बारे में जानकारी का अनुरोध करने के लिए, Place Details (New) के नए अनुरोध में movedPlace फ़ील्ड में जगह के रिसॉर्स का नाम इस्तेमाल करें.

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

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

आने वाले समय में खुलने वाले कारोबारों के बारे में जानकारी का अनुरोध किया जा सकता है. अगर कारोबार के खुलने की अनुमानित तारीख में कम से कम महीना शामिल है और वह 90 दिनों से कम है, तो आस-पास की जगहों की जानकारी (नई) openingDate फ़ील्ड में जानकारी भर देगी.

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

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

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

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

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

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

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

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

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

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

रास्ते और नेविगेशन पॉइंट पाना

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

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

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

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

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

{
  "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 विंडो बड़ी हो जाएगी.