जगह की जानकारी (लेगसी)

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

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

जगह के बारे में ज़्यादा जानकारी (लेगसी) के अनुरोध

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

https://maps.googleapis.com/maps/api/place/details/output?parameters

यहां output इनमें से कोई भी वैल्यू हो सकती है:

  • json (सुझाया गया) से पता चलता है कि आउटपुट JavaScript Object Notation (JSON) में है
  • xml से पता चलता है कि आउटपुट एक्सएमएल के तौर पर है

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

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

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

  • फ़ील्ड्स

    ध्यान दें: जगह के लिए खोज करने के अनुरोध और जगह के बारे में ज़्यादा जानकारी पाने के अनुरोध पर, एक जैसे फ़ील्ड नहीं मिलते. जगह के लिए खोज के अनुरोधों से, उन फ़ील्ड का सबसेट मिलता है जो जगह के बारे में ज़्यादा जानकारी के अनुरोधों से मिलता है. अगर आपको जो फ़ील्ड चाहिए वह Place Search के जवाब में नहीं मिलता है, तो Place Search का इस्तेमाल करके place_id पाएं. इसके बाद, उस Place ID का इस्तेमाल करके, जगह के बारे में ज़्यादा जानकारी पाने का अनुरोध करें. जगह के बारे में खोज करने के अनुरोध में उपलब्ध न होने वाले फ़ील्ड के बारे में ज़्यादा जानने के लिए, Places API के फ़ील्ड के साथ काम करने की सुविधा देखें.

    फ़ील्ड पैरामीटर का इस्तेमाल करके, जगह के डेटा टाइप की कॉमा से अलग की गई सूची तय करें. उदाहरण के लिए: fields=formatted_address,name,geometry. एक से ज़्यादा वैल्यू तय करते समय, फ़ॉरवर्ड स्लैश का इस्तेमाल करें. उदाहरण के लिए: opening_hours/open_now.

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

    बेसिक

    बुनियादी कैटगरी में ये फ़ील्ड शामिल हैं: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (deprecated), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

    संपर्क करना

    संपर्क कैटगरी में ये फ़ील्ड शामिल हैं: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

    माहौल

    एटमॉस्फ़ियर कैटगरी में ये फ़ील्ड शामिल हैं: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

    ध्यान दें: एट्रिब्यूशन, html_attributions, हर कॉल के साथ हमेशा दिखाए जाते हैं. भले ही, फ़ील्ड का अनुरोध किया गया हो या नहीं.
  • भाषा

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

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

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

  • reviews_no_translations

    समीक्षाओं के अनुवाद की सुविधा बंद करने के लिए, reviews_no_translations=true तय करें. समीक्षाओं के अनुवाद की सुविधा चालू करने के लिए, reviews_no_translations=false तय करें. समीक्षाएं उनकी मूल भाषा में वापस लाई जाती हैं.

    अगर इसे शामिल नहीं किया जाता है या इसकी कोई वैल्यू नहीं दी जाती है, तो समीक्षाओं के अनुवाद की सुविधा चालू हो जाती है. अगर अनुरोध में language पैरामीटर तय किया गया था, तो अनुवाद के लिए तय की गई भाषा का इस्तेमाल करें. अगर language को शामिल नहीं किया जाता है, तो एपीआई Accept-Language हेडर को पसंदीदा भाषा के तौर पर इस्तेमाल करने की कोशिश करता है.

  • reviews_sort

    समीक्षाएं दिखाते समय, क्रम से लगाने के लिए इस्तेमाल किया जाने वाला तरीका. इसे most_relevant (डिफ़ॉल्ट) या newest पर सेट किया जा सकता है.

    • most_relevant (डिफ़ॉल्ट) के लिए, समीक्षाओं को काम के हिसाब से क्रम में लगाया जाता है. सेवा, नतीजों को इस तरह से व्यवस्थित करेगी कि पसंदीदा भाषा में लिखी गई समीक्षाएं सबसे पहले दिखें.
    • newest के लिए, समीक्षाओं को समय के हिसाब से क्रम में लगाया जाता है. पसंदीदा भाषा से, क्रम पर कोई असर नहीं पड़ता.

    Google का सुझाव है कि आप असली उपयोगकर्ता को यह दिखाएं कि समीक्षाओं को कैसे क्रम से लगाया जा रहा है.

  • sessiontoken

    यह एक रैंडम स्ट्रिंग है. इससे बिलिंग के लिए, अपने-आप भरने की सुविधा वाले सेशन की पहचान की जाती है.

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

    हमारा सुझाव है कि आप इन दिशा-निर्देशों का पालन करें:

    • ऑटोमैटिक भरने की सुविधा वाले सभी सेशन के लिए, सेशन टोकन का इस्तेमाल करें.
    • हर सेशन के लिए नया टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 यूयूआईडी का इस्तेमाल करें.
    • पक्का करें कि किसी सेशन में Place Autocomplete और Place Details के सभी अनुरोधों के लिए इस्तेमाल की गई एपीआई कुंजियां, एक ही Cloud Console प्रोजेक्ट से जुड़ी हों.
    • पक्का करें कि हर नए सेशन के लिए, एक यूनीक सेशन टोकन पास किया गया हो. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध के लिए अलग से बिल भेजा जाएगा.

जगह के बारे में ज़्यादा जानकारी (लेगसी) का उदाहरण

यहां दिए गए उदाहरण में, place_id के हिसाब से किसी जगह की जानकारी का अनुरोध किया गया है. इसमें name, rating, और formatted_phone_number फ़ील्ड शामिल हैं:

शेल

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

ध्यान दें कि इस उदाहरण में दी गई कुंजी को आपको अपनी एपीआई कुंजी से बदलना होगा, ताकि आपका अनुरोध आपके ऐप्लिकेशन में काम कर सके.

जगह के बारे में ज़्यादा जानकारी (लेगसी) का जवाब

जगह के बारे में ज़्यादा जानकारी (लेगसी) के जवाब, अनुरोध के यूआरएल पाथ में मौजूद output फ़्लैग से तय किए गए फ़ॉर्मैट में मिलते हैं.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM  5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

    

JSON और एक्सएमएल, दोनों तरह के रिस्पॉन्स में ये एलिमेंट शामिल होते हैं:

PlacesDetailsResponse

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है Array<string>

इसमें इस लिस्टिंग के बारे में एट्रिब्यूशन का एक सेट शामिल हो सकता है, जिसे उपयोगकर्ता को दिखाना ज़रूरी है. ऐसा हो सकता है कि कुछ लिस्टिंग में एट्रिब्यूशन न हो.

ज़रूरी है जगह

इसमें उस जगह के बारे में पूरी जानकारी होती है जिसके बारे में अनुरोध किया गया है.

ज़्यादा जानकारी के लिए, जगह देखें.

ज़रूरी है PlacesDetailsStatus

इसमें अनुरोध की स्थिति के बारे में जानकारी होती है. इसमें डीबग करने से जुड़ी जानकारी भी हो सकती है. इससे आपको यह पता लगाने में मदद मिलती है कि अनुरोध क्यों पूरा नहीं हुआ.

ज़्यादा जानकारी के लिए, PlacesDetailsStatus देखें.

ज़रूरी नहीं Array<string>

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

JSON रिस्पॉन्स में, इन्हें रूट एलिमेंट के तौर पर दिखाया जाता है. XML रिस्पॉन्स में, ये <PlaceDetailsResponse> के नीचे टॉप-लेवल एलिमेंट के तौर पर दिखते हैं.

PlacesDetailsStatus

सेवा से मिले स्टेटस कोड.

  • OK से पता चलता है कि एपीआई अनुरोध पूरा हो गया है.
  • ZERO_RESULTS से पता चलता है कि रेफ़र की गई जगह की जानकारी, place_id, मान्य थी, लेकिन अब यह मान्य नतीजे से नहीं जुड़ी है. ऐसा तब हो सकता है, जब कारोबार बंद हो गया हो.
  • NOT_FOUND से पता चलता है कि रेफ़र की गई जगह, place_id, Places डेटाबेस में नहीं मिली.
  • INVALID_REQUEST से पता चलता है कि एपीआई अनुरोध सही नहीं था.
  • OVER_QUERY_LIMIT इनमें से किसी एक के बारे में बताता है:
    • आपने क्यूपीएस की सीमाएं पार कर ली हैं.
    • आपके खाते में बिलिंग की सुविधा चालू नहीं है.
    • महीने के 200 डॉलर के क्रेडिट या इस्तेमाल की तय सीमा को पार कर लिया गया है.
    • पेमेंट का वह तरीका अब मान्य नहीं है जिसे आपने चुना है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है.
    इस गड़बड़ी को ठीक करने के तरीके के बारे में ज़्यादा जानने के लिए, Maps के बारे में अक्सर पूछे जाने वाले सवाल देखें.
  • REQUEST_DENIED में बताया गया है कि आपका अनुरोध अस्वीकार कर दिया गया है. आम तौर पर, इसकी वजह यह होती है:
    • अनुरोध में एपीआई पासकोड मौजूद नहीं है.
    • key पैरामीटर अमान्य है.
  • UNKNOWN_ERROR से पता चलता है कि कोई गड़बड़ी हुई है.

जगह

किसी जगह की जानकारी देने वाले एट्रिब्यूट. सभी तरह की जगहों के लिए, सभी एट्रिब्यूट उपलब्ध नहीं होंगे.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं Array<AddressComponent>

यह एक कैटगरी है, जिसमें इस पते पर लागू होने वाले अलग-अलग कॉम्पोनेंट शामिल होते हैं.

ज़्यादा जानकारी के लिए, AddressComponent पर जाएं.

ज़रूरी नहीं स्ट्रिंग

जगह के पते को adr microformat में दिखाया गया है.

ज़रूरी नहीं स्ट्रिंग

अगर कोई जगह कारोबार है, तो इससे उसकी चालू स्थिति के बारे में पता चलता है. अगर कोई डेटा मौजूद नहीं है, तो business_status नहीं दिखाया जाता.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार, कर्बसाइड पिकअप की सुविधा देता है या नहीं.

ज़रूरी नहीं PlaceOpeningHours

इसमें अगले सात दिनों के लिए काम के घंटे शामिल होते हैं. इनमें आज के दिन के घंटे भी शामिल हैं. यह समयावधि, अनुरोध की तारीख को आधी रात से शुरू होती है और छह दिन बाद रात 11:59 बजे खत्म होती है. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.

ज़्यादा जानकारी के लिए, PlaceOpeningHours देखें.

ज़रूरी नहीं बूलियन

इससे यह पता चलता है कि कारोबार डिलीवरी की सुविधा देता है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार में, अंदर या बाहर बैठने की सुविधा है या नहीं.

ज़रूरी नहीं PlaceEditorialSummary

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

ज़्यादा जानकारी के लिए, PlaceEditorialSummary देखें.

ज़रूरी नहीं स्ट्रिंग

इस स्ट्रिंग में, इस जगह का पता होता है. इसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

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

फ़ॉर्मैट किया गया पता, लॉजिक के हिसाब से एक या उससे ज़्यादा पते के कॉम्पोनेंट से बना होता है. उदाहरण के लिए, "111 8th Avenue, New York, NY" पते में ये कॉम्पोनेंट शामिल हैं: "111" (सड़क का नंबर), "8th Avenue" (रास्ता), "New York" (शहर), और "NY" (अमेरिका का राज्य).

फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट का इस्तेमाल करना चाहिए. एपीआई के जवाब में, फ़ॉर्मैट किए गए पते वाले फ़ील्ड के साथ-साथ ये कॉम्पोनेंट भी शामिल होते हैं.

ज़रूरी नहीं स्ट्रिंग

इसमें जगह का फ़ोन नंबर, स्थानीय फ़ॉर्मैट में होता है.

ज़रूरी नहीं Geometry

इसमें जगह की जानकारी और जगह के लिए व्यूपोर्ट होता है.

ज़्यादा जानकारी के लिए, Geometry पर जाएं.

ज़रूरी नहीं स्ट्रिंग

इसमें सुझाए गए आइकॉन का यूआरएल होता है. इस आइकॉन को मैप पर यह नतीजा दिखाते समय, उपयोगकर्ता को दिखाया जा सकता है.

ज़रूरी नहीं स्ट्रिंग

इसमें जगह की कैटगरी के लिए डिफ़ॉल्ट एचईएक्स कलर कोड होता है.

ज़रूरी नहीं स्ट्रिंग

इसमें सुझाए गए आइकॉन का यूआरएल होता है. इसमें .svg या .png फ़ाइल टाइप एक्सटेंशन शामिल नहीं होता.

ज़रूरी नहीं स्ट्रिंग

इसमें जगह का फ़ोन नंबर, अंतरराष्ट्रीय फ़ॉर्मैट में होता है. अंतरराष्ट्रीय फ़ॉर्मैट में देश का कोड शामिल होता है. साथ ही, इसके पहले प्लस (+) का निशान होता है. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में मौजूद Google के ऑफ़िस का international_phone_number +61 2 9374 4000 है.

ज़रूरी नहीं स्ट्रिंग

इसमें, दिखाए गए नतीजे का ऐसा नाम होता है जिसे आसानी से पढ़ा जा सकता है. establishment नतीजों के लिए, यह आम तौर पर कारोबार का कैननिकल नाम होता है.

ज़रूरी नहीं PlaceOpeningHours

इसमें कारोबार के खुले रहने का सामान्य समय शामिल होता है.

ज़्यादा जानकारी के लिए, PlaceOpeningHours देखें.

ज़रूरी नहीं बूलियन

कारोबारों के चालू होने की स्थिति जानने के लिए, business_status का इस्तेमाल करें.

ज़रूरी नहीं Array<PlacePhoto>

फ़ोटो ऑब्जेक्ट का कलेक्शन. हर ऑब्जेक्ट में, किसी इमेज का रेफ़रंस होता है. अनुरोध के जवाब में, ज़्यादा से ज़्यादा दस फ़ोटो मिल सकती हैं. जगह की फ़ोटो और अपने ऐप्लिकेशन में इमेज इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी, जगह की फ़ोटो दस्तावेज़ में देखी जा सकती है.

ज़्यादा जानकारी के लिए, PlacePhoto देखें.

ज़रूरी नहीं स्ट्रिंग

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

ज़रूरी नहीं PlusCode

यह अक्षांश और देशांतर के कोऑर्डिनेट से मिला, एन्कोड किया गया जगह का रेफ़रंस होता है. यह किसी जगह को दिखाता है: 1/8000 डिग्री x 1/8000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. Plus Codes का इस्तेमाल, उन जगहों पर मोहल्ले के पतों की जगह किया जा सकता है जहां वे मौजूद नहीं हैं. जैसे, जहां इमारतों के नंबर नहीं होते या सड़कों के नाम नहीं होते. ओपन लोकेशन कोड और प्लस कोड देखें.

ज़्यादा जानकारी के लिए, PlusCode पर जाएं.

ज़रूरी नहीं संख्या

जगह के किराये का लेवल, 0 से 4 के स्केल पर. किसी वैल्यू से मिलने वाली सटीक रकम, इलाके के हिसाब से अलग-अलग होगी. कीमत के लेवल को इस तरह से समझा जाता है:

  • 0 मुफ़्त
  • 1 सस्ता
  • 2 सामान्य
  • 3 महंगा
  • 4 बहुत महंगा
ज़रूरी नहीं संख्या

इसमें जगह की रेटिंग होती है. यह 1.0 से 5.0 तक होती है. यह रेटिंग, उपयोगकर्ताओं की कुल समीक्षाओं के आधार पर तय की जाती है.

ज़रूरी नहीं स्ट्रिंग
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर बुकिंग की सुविधा उपलब्ध है या नहीं.

ज़रूरी नहीं Array<PlaceReview>

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

  • most_relevant (डिफ़ॉल्ट) के लिए, समीक्षाओं को काम के हिसाब से क्रम में लगाया जाता है. सेवा, नतीजों को इस तरह से व्यवस्थित करेगी कि पसंदीदा भाषा में लिखी गई समीक्षाएं सबसे पहले दिखें.
  • newest के लिए, समीक्षाओं को समय के हिसाब से क्रम में लगाया जाता है. पसंदीदा भाषा से, क्रम पर कोई असर नहीं पड़ता.

Google का सुझाव है कि उपयोगकर्ताओं को यह बताया जाए कि नतीजे most_relevant या newest के हिसाब से क्रम में लगाए गए हैं.

ज़्यादा जानकारी के लिए, PlaceReview देखें.

ज़रूरी नहीं स्ट्रिंग
ज़रूरी नहीं Array<PlaceOpeningHours>

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

ज़्यादा जानकारी के लिए, PlaceOpeningHours देखें.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर बीयर मिलती है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर नाश्ता मिलता है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर ब्रंच परोसा जाता है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर डिनर मिलता है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि क्या इस जगह पर लंच परोसा जाता है.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर शाकाहारी खाना मिलता है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर वाइन मिलती है या नहीं.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार में खाना पैक कराने की सुविधा उपलब्ध है या नहीं.

ज़रूरी नहीं Array<string>

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

ज़रूरी नहीं स्ट्रिंग

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

ज़रूरी नहीं संख्या

इस जगह के लिए, टेक्स्ट के साथ या बिना टेक्स्ट वाली समीक्षाओं की कुल संख्या.

ज़रूरी नहीं संख्या

इसमें यह जानकारी होती है कि इस जगह का मौजूदा टाइमज़ोन, यूटीसी से कितने मिनट आगे या पीछे है. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में डेलाइट सेविंग टाइम के दौरान यह 660 (+11 घंटे यूटीसी से) होगा. वहीं, कैलिफ़ोर्निया में डेलाइट सेविंग टाइम के बाहर यह -480 (-8 घंटे यूटीसी से) होगा.

ज़रूरी नहीं स्ट्रिंग

कारोबार की जगह (types:["establishment", ...]) सिर्फ़ नतीजों के लिए) के लिए, vicinity फ़ील्ड में जगह का आसान पता होता है. इसमें सड़क का नाम, सड़क का नंबर, और इलाका शामिल होता है. हालांकि, इसमें प्रांत/राज्य, पिन कोड या देश शामिल नहीं होता है.

अन्य सभी नतीजों के लिए, vicinity फ़ील्ड में, राजनैतिक (types:["political", ...]) तौर पर सबसे छोटे क्षेत्र का नाम होता है. यह क्षेत्र, नतीजे के पते में मौजूद होता है.

इस कॉन्टेंट को जैसा है वैसा ही पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें.

ज़रूरी नहीं स्ट्रिंग

इस जगह की आधिकारिक वेबसाइट, जैसे कि किसी कारोबार का होम पेज.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह में व्हीलचेयर लाने-ले जाने की सुविधा वाला दरवाज़ा है या नहीं.

PlaceEditorialSummary

इसमें जगह की खास जानकारी होती है. खास जानकारी में टेक्स्ट के रूप में खास जानकारी दी जाती है. साथ ही, अगर लागू हो, तो इसमें भाषा कोड भी शामिल होता है. जवाब के टेक्स्ट को उसी रूप में दिखाना होगा. इसमें बदलाव नहीं किया जा सकता.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं स्ट्रिंग

पिछले फ़ील्ड की भाषा. ऐसा हो सकता है कि यह हमेशा मौजूद न हो.

ज़रूरी नहीं स्ट्रिंग

जगह के बारे में, टेक्स्ट के रूप में दी गई खास जानकारी. यह जानकारी न तो बहुत छोटी होती है और न ही बहुत बड़ी.

PlaceOpeningHours

किसी जगह के खुले होने के समय की जानकारी देने वाला ऑब्जेक्ट.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं बूलियन

बूलियन वैल्यू, जिससे यह पता चलता है कि जगह अभी खुली है या नहीं.

ज़रूरी नहीं Array<PlaceOpeningHoursPeriod>

यह सात दिनों के लिए, कारोबार के खुले होने के समय की जानकारी देने वाला कलेक्शन है. इसमें रविवार से शुरू होने वाले दिनों की जानकारी, क्रम से दी जाती है.

ज़्यादा जानकारी के लिए, PlaceOpeningHoursPeriod देखें.

ज़रूरी नहीं Array<PlaceSpecialDay>

यह अगले सात दिनों के लिए, ज़्यादा से ज़्यादा सात एंट्री वाला एक कलेक्शन होता है.

ज़्यादा जानकारी के लिए, PlaceSpecialDay देखें.

ज़रूरी नहीं स्ट्रिंग

यह एक टाइप स्ट्रिंग है. इसका इस्तेमाल, कारोबार के दूसरे समय की जानकारी के टाइप की पहचान करने के लिए किया जाता है. उदाहरण के लिए, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS. इसे सिर्फ़ secondary_opening_hours के लिए सेट किया जाता है.

ज़रूरी नहीं Array<string>

यह स्ट्रिंग का एक ऐसा कलेक्शन होता है जिसमें किसी जगह के खुलने और बंद होने के समय के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

PlaceOpeningHoursPeriod

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है PlaceOpeningHoursPeriodDetail

इसमें दिन और समय के ऑब्जेक्ट का एक पेयर होता है. इससे पता चलता है कि जगह कब खुलती है.

ज़्यादा जानकारी के लिए, PlaceOpeningHoursPeriodDetail देखें.

ज़रूरी नहीं PlaceOpeningHoursPeriodDetail

इसमें दिन और समय के ऑब्जेक्ट का एक ऐसा पेयर शामिल हो सकता है जिससे यह पता चलता है कि जगह कब बंद होती है. अगर कोई जगह हमेशा खुली रहती है, तो जवाब में 'बंद होने का समय' सेक्शन नहीं दिखेगा. क्लाइंट, हमेशा खुले रहने की सुविधा के लिए इस बात पर भरोसा कर सकते हैं कि इसे खुले रहने की अवधि के तौर पर दिखाया जाएगा. इसमें दिन की वैल्यू 0 और समय की वैल्यू 0000 होगी. साथ ही, इसमें close नहीं होगा.

ज़्यादा जानकारी के लिए, PlaceOpeningHoursPeriodDetail देखें.

PlaceSpecialDay

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं स्ट्रिंग

किसी जगह के स्थानीय टाइमज़ोन के हिसाब से, RFC3339 फ़ॉर्मैट में तारीख. उदाहरण के लिए, 2010-12-31.

ज़रूरी नहीं बूलियन

अगर इस दिन के लिए, कारोबार के खुले होने का समय सामान्य से अलग है, तो यह वैल्यू सही होती है. अगर true है, तो इसका मतलब है कि इस दिन के लिए कम से कम एक अपवाद है. अपवादों की वजह से, current_opening_hours और secondary_opening_hours के सब-फ़ील्ड में अलग-अलग वैल्यू दिखती हैं. जैसे, periods, weekday_text, open_now. अपवाद, समय के लिए लागू होते हैं. साथ ही, समय का इस्तेमाल अन्य फ़ील्ड जनरेट करने के लिए किया जाता है.

PlaceOpeningHoursPeriodDetail

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

यह 0 से 6 तक की कोई संख्या होती है. यह हफ़्ते के दिनों के हिसाब से होती है. इसकी शुरुआत रविवार से होती है. उदाहरण के लिए, 2 का मतलब मंगलवार है.

ज़रूरी है स्ट्रिंग

इसमें 24 घंटे वाले hhmm फ़ॉर्मैट में दिन का समय शामिल हो सकता है. वैल्यू 0000–2359 की रेंज में होनी चाहिए. समय की जानकारी, जगह के टाइम ज़ोन के हिसाब से दी जाएगी.

ज़रूरी नहीं स्ट्रिंग

किसी जगह के स्थानीय टाइमज़ोन के हिसाब से, RFC3339 फ़ॉर्मैट में तारीख. उदाहरण के लिए, 2010-12-31.

ज़रूरी नहीं बूलियन

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

PlacePhoto

किसी जगह की फ़ोटो. फ़ोटो को Place Photo API का इस्तेमाल करके ऐक्सेस किया जा सकता है. इसके लिए, इस पैटर्न में यूआरएल का इस्तेमाल करें:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

ज़्यादा जानकारी के लिए, जगह की फ़ोटो देखें.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

फ़ोटो की ऊंचाई.

ज़रूरी है Array<string>

फ़ोटो के लिए एचटीएमएल एट्रिब्यूशन.

ज़रूरी है स्ट्रिंग

यह एक स्ट्रिंग है. इसका इस्तेमाल, फ़ोटो का अनुरोध करते समय फ़ोटो की पहचान करने के लिए किया जाता है.

ज़रूरी है संख्या

फ़ोटो की चौड़ाई.

PlaceReview

किसी व्यक्ति ने जगह की समीक्षा सबमिट की है.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है स्ट्रिंग

समीक्षा सबमिट करने वाले व्यक्ति का नाम. पहचान छिपाकर की गई समीक्षाओं को "Google उपयोगकर्ता" के तौर पर दिखाया जाता है.

ज़रूरी है संख्या

इस जगह के लिए उपयोगकर्ता की कुल रेटिंग. यह एक पूर्णांक है, जो 1 से 5 के बीच होता है.

ज़रूरी है स्ट्रिंग

समीक्षा को टेक्स्ट में सबमिट करने का समय, मौजूदा समय के हिसाब से.

ज़रूरी है संख्या

समीक्षा सबमिट करने का समय. इसे 1 जनवरी, 1970 को 00:00:00 यूटीसी से लेकर अब तक के सेकंड की संख्या के हिसाब से मापा जाता है.

ज़रूरी नहीं स्ट्रिंग

अगर उपयोगकर्ता की Google Maps Local Guides प्रोफ़ाइल उपलब्ध है, तो उसका यूआरएल.

ज़रूरी नहीं स्ट्रिंग

यह एक आईईटीएफ़ भाषा कोड है. इससे पता चलता है कि जवाब में दी गई समीक्षा किस भाषा में है. इस फ़ील्ड में सिर्फ़ मुख्य भाषा का टैग होता है. इसमें देश या इलाके के बारे में बताने वाला सेकंडरी टैग नहीं होता. उदाहरण के लिए, अंग्रेज़ी में लिखी गई सभी समीक्षाओं को 'en' के तौर पर टैग किया जाता है, न कि 'en-AU' या 'en-UK' के तौर पर. इसी तरह, अन्य भाषाओं में लिखी गई समीक्षाओं को भी टैग किया जाता है. अगर सिर्फ़ रेटिंग दी गई है और समीक्षा का टेक्स्ट नहीं है, तो यह फ़ील्ड खाली होता है.

ज़रूरी नहीं स्ट्रिंग

यह एक आईईटीएफ़ भाषा कोड है. इससे समीक्षा की मूल भाषा के बारे में पता चलता है. अगर समीक्षा का अनुवाद किया गया है, तो original_language != language. इस फ़ील्ड में सिर्फ़ मुख्य भाषा का टैग होता है. इसमें देश या इलाके की जानकारी देने वाला सेकंडरी टैग नहीं होता. उदाहरण के लिए, अंग्रेज़ी में लिखी गई सभी समीक्षाओं को 'en' के तौर पर टैग किया जाता है, न कि 'en-AU' या 'en-UK' वगैरह के तौर पर.अगर सिर्फ़ रेटिंग दी गई है और समीक्षा का टेक्स्ट नहीं है, तो यह फ़ील्ड खाली होता है.

ज़रूरी नहीं स्ट्रिंग

अगर उपलब्ध हो, तो उपयोगकर्ता की प्रोफ़ाइल फ़ोटो का यूआरएल.

ज़रूरी नहीं स्ट्रिंग

उपयोगकर्ता की समीक्षा. Google Places पर किसी जगह की समीक्षा करते समय, टेक्स्ट वाली समीक्षाएं देना ज़रूरी नहीं है. इसलिए, यह फ़ील्ड खाली हो सकता है. ध्यान दें कि इस फ़ील्ड में बेसिक एचटीएमएल मार्कअप शामिल हो सकता है. उदाहरण के लिए, एंटिटी रेफ़रंस &amp;, ऐंड सिंबल को दिखा सकता है.

ज़रूरी नहीं बूलियन

बूलियन वैल्यू से पता चलता है कि समीक्षा का अनुवाद, उसकी मूल भाषा से किया गया है या नहीं. अगर किसी समीक्षा का अनुवाद किया गया है, तो Google का सुझाव है कि आप अपने उपयोगकर्ताओं को इस बारे में बताएं. इसके लिए, आपको true वैल्यू का इस्तेमाल करना होगा. उदाहरण के लिए, समीक्षा में "Google ने अनुवाद किया" स्ट्रिंग जोड़ी जा सकती है.