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

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

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

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

Nearby Search (लेगसी) का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:

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

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

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

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

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

  • जगह

    वह पॉइंट जिसके आस-पास की जगह की जानकारी वापस लानी है. इसे latitude,longitude के तौर पर तय किया जाना चाहिए.

  • दायरा

    यह जगह के नतीजों को दिखाने के लिए, दूरी (मीटर में) तय करता है. location और radius पैरामीटर पास करके, किसी खास सर्कल के हिसाब से नतीजे दिखाए जा सकते हैं. ऐसा करने पर, Places सेवा को उस सर्कल के अंदर के नतीजे दिखाने के लिए प्राथमिकता देने का निर्देश मिलता है. हालांकि, तय की गई जगह से बाहर के नतीजे अब भी दिखाए जा सकते हैं.

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

    • ऑटोकंप्लीट: 50,000 मीटर
    • आस-पास की जगहों की जानकारी:
      • keyword या name के साथ: 50,000 मीटर
      • keyword या name के बिना
        • यह 50,000 मीटर तक हो सकता है. यह इलाके की आबादी के हिसाब से, अपने-आप अडजस्ट होता है. यह rankby पैरामीटर से अलग होता है.
        • rankby=distance का इस्तेमाल करने पर, रेडियस पैरामीटर स्वीकार नहीं किया जाएगा. इससे INVALID_REQUEST दिखेगा.
    • क्वेरी अपने-आप पूरी होने की सुविधा: 50,000 मीटर
    • टेक्स्ट से खोजें: 50,000 मीटर

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

  • कीवर्ड

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

    इस पैरामीटर का इस्तेमाल करके, जगह की जानकारी को साफ़ तौर पर शामिल करने से, जगह, दायरा, और rankby पैरामीटर के साथ टकराव हो सकता है. इससे अनचाहे नतीजे मिल सकते हैं.

    अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो कारोबार की स्थिति के तौर पर CLOSED_TEMPORARILY या CLOSED_PERMANENTLY के तौर पर मार्क की गई जगहों की जानकारी नहीं दिखाई जाएगी.

  • भाषा

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

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

    नतीजों को सिर्फ़ उस रेंज में मौजूद जगहों तक सीमित करता है. मान्य वैल्यू, 0 (सबसे सस्ता) से लेकर 4 (सबसे महंगा) के बीच होती हैं. इसमें ये दोनों वैल्यू भी शामिल हैं. किसी वैल्यू से मिलने वाली सटीक रकम, इलाके के हिसाब से अलग-अलग होगी.

  • minprice

    नतीजों को सिर्फ़ उस रेंज में मौजूद जगहों तक सीमित करता है. मान्य वैल्यू, 0 (सबसे सस्ता) से लेकर 4 (सबसे महंगा) के बीच होती हैं. इसमें ये दोनों वैल्यू भी शामिल हैं. किसी वैल्यू से मिलने वाली सटीक रकम, इलाके के हिसाब से अलग-अलग होगी.

  • नाम

    keyword के बराबर. इस फ़ील्ड में मौजूद वैल्यू को keyword फ़ील्ड में मौजूद वैल्यू के साथ जोड़ दिया जाता है. इसके बाद, इसे एक ही खोज स्ट्रिंग के हिस्से के तौर पर पास किया जाता है.

  • opennow

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

  • pagetoken

    यह पिछली खोज के ज़्यादा से ज़्यादा 20 नतीजे दिखाता है. pagetoken पैरामीटर सेट करने पर, पहले इस्तेमाल किए गए पैरामीटर के साथ खोज की जाएगी. pagetoken के अलावा, सभी पैरामीटर को अनदेखा कर दिया जाएगा.

  • rankby

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

    • prominence (डिफ़ॉल्ट). इस विकल्प से, नतीजों को उनकी अहमियत के हिसाब से क्रम में लगाया जाता है. रैंकिंग में, सेट किए गए दायरे में मौजूद लोकप्रिय जगहों को, आस-पास की उन जगहों के मुकाबले ज़्यादा प्राथमिकता दी जाएगी जो मिलती-जुलती हैं, लेकिन कम लोकप्रिय हैं. किसी जगह की प्रमुखता पर, Google के इंडेक्स में उसकी रैंकिंग, दुनिया भर में उसकी लोकप्रियता, और अन्य बातों का असर पड़ सकता है. अगर अहमियत की जानकारी दी गई है, तो radius पैरामीटर का इस्तेमाल करना ज़रूरी है.
    • distance. इस विकल्प से, खोज के नतीजों को बढ़ते क्रम में लगाया जाता है. यह क्रम, तय की गई जगह से दूरी के हिसाब से होता है. distance की वैल्यू तय करने पर, keyword, name या type में से एक या उससे ज़्यादा वैल्यू देना ज़रूरी है. साथ ही, radius की वैल्यू नहीं दी जा सकती.
  • टाइप

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

    • type=hospital|pharmacy|doctor type=hospital हो जाता है
    • type=hospital,pharmacy,doctor को पूरी तरह से अनदेखा किया जाता है

    इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.

    ध्यान दें: keyword और type, दोनों को एक ही वैल्यू (keyword=cafe&type=cafe या keyword=parking&type=parking) के साथ जोड़ने पर ZERO_RESULTS मिल सकता है.

आस-पास की जगहों की जानकारी (लेगसी) का उदाहरण

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

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

आस-पास की जगहों की जानकारी (लेगसी) के जवाब

यहां आस-पास की जगहों की जानकारी (लेगसी) के अनुरोध के जवाब का उदाहरण दिया गया है.

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "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",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8676569, "lng": 151.2017213 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86629922010728, "lng": 151.2031712798927 },
                "southwest":
                  { "lat": -33.86899887989272, "lng": 151.2004716201073 },
              },
          },
        "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",
        "name": "Clearview Sydney Harbour Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 685,
              "html_attributions":
                [
                  'Clearview Glass Boat Cruises',
                ],
              "photo_reference": "Aap_uEAlExjnXA0VWyb_oYwCJ8utWG_Ennhwmn_xadpgenMNUgTuxrvgf1Xdw4bsbL6kFSWH7bhbpVHK1esdNY37ancJvbL_Gnsc7EZ5KEBNPvYZ_ZEyLco4a5v34LFkodxfFZbJ-ejO3zN4W_0C37P5jAmTnLWMNFYUPvoU3UMi70qHRNF5",
              "width": 1024,
            },
          ],
        "place_id": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.8,
        "reference": "ChIJNQfwZTiuEmsR1m1x9w0E2V0",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 49,
        "vicinity": "32 The Promenade King Street Wharf 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Sydney Harbour Lunch Cruise",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 545,
              "html_attributions":
                [
                  'Sydney Harbour Lunch Cruise',
                ],
              "photo_reference": "Aap_uEBFyQ2xDzHk7dGF_FTvNeJ01NQD6GROq89rufdGQl5Gi0zVfpnETBjPK2v7UEDl_6F-m8aR5FcEWJMqPaH4Oh_CQh2jaUAUAesUInucpCe7OFdleSYJ_8kgunhsIvGf1D1s_pes6Rk2JMVEs8rEs6ZHSTmUQXX2Yh-Gt9MuPQdYNuNv",
              "width": 969,
            },
          ],
        "place_id": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJUbf3iDiuEmsROJxXbhYO7cM",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 23,
        "vicinity": "5/32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675883, "lng": 151.2016452 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86623847010728, "lng": 151.2029950298927 },
                "southwest":
                  { "lat": -33.86893812989273, "lng": 151.2002953701073 },
              },
          },
        "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",
        "name": "Sydney Showboats - Dinner Cruise With Show",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4912,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uED1aGaMs8xYfiuzeBqVcFsk3yguUujdE4S3rNThMpLtoU0RukF40KCt0CAxgHP1HoY8Z7NYcWvax6qmMMVPBbmzGhoaiwiAAyv2GGA9vhcgsJ5w0LweT0y1lgRGZxU3nZIdNLiYAp9JHM171UkN04H6UqYSxKVZ8N_f2aslkqOaBF_e",
              "width": 7360,
            },
          ],
        "place_id": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.1,
        "reference": "ChIJjRuIiTiuEmsRCHhYnrWiSok",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 119,
        "vicinity": "32 The Promenade, King Street Wharf, 5, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Magistic Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEC8bq-YphfIDcdxANBfgGMBIX2B0ggNep9ddVoePj6sfdcdusIn07x8biaxevZ_6BpzDDRsUL8No5P3ftI4on_pqbAbIEUL5gFGgezpVZ3M9GWvKdJm3njO_aJaghWl4_aQb75c0WGYDRFPhn6fWsLkD7KxodviJeCX4OCGt1eRJnlK",
              "width": 2048,
            },
          ],
        "place_id": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 3.9,
        "reference": "ChIJxRjqYTiuEmsRGebAA_chDLE",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 99,
        "vicinity": "King Street Wharf, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8609391, "lng": 151.2098735 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85958927010727, "lng": 151.2112233298927 },
                "southwest":
                  { "lat": -33.86228892989272, "lng": 151.2085236701072 },
              },
          },
        "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",
        "name": "Australian Cruise Group",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 1536,
              "html_attributions":
                [
                  'Keith Bauman',
                ],
              "photo_reference": "Aap_uED7aBwIbN6iuoZi8e9xCrt6F_EhppGCBfzYCgypetw8cGn4Ui0Y3JZe3QJ0buf0zc54BtPz-SWXxecPd6kDvNNZD5Eu_ZzTP13rXMzSDJa6UcwFiXU4y3qYrWAyJ6mtYrd2PJgw0KzvYaZoPze7Ka6zG6k3IOjeSICDYH6YOzkXhelj",
              "width": 2048,
            },
          ],
        "place_id": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "plus_code":
          {
            "compound_code": "46Q5+JW Sydney, New South Wales",
            "global_code": "4RRH46Q5+JW",
          },
        "rating": 4.4,
        "reference": "ChIJpU8KgUKuEmsRKErVGEaa11w",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "6 Cirular Quay, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8686058, "lng": 151.2018206 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86730002010728, "lng": 151.2032717798927 },
                "southwest":
                  { "lat": -33.86999967989272, "lng": 151.2005721201073 },
              },
          },
        "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",
        "name": "Rhythmboat Cruises",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 2269,
              "html_attributions":
                [
                  'Rhythmboat Sydney Harbour Cruises',
                ],
              "photo_reference": "Aap_uEAT8eop-IsfSAQ3KP6YXRNRsFkESXDecsaPnaVhq5bZzny5guvhS4smciianRGbZgDtFtAcU-ZXTaBfuh80CFw8vpJyKaB4grgW_CW64rU1JF9FDy_M8HtEk3rOrMhPDiF8ns-mc16E4rWSuAQIc76Du_eCd63ofoErESOtSWAQVcew",
              "width": 4032,
            },
          ],
        "place_id": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "plus_code":
          {
            "compound_code": "46J2+HP Sydney, New South Wales",
            "global_code": "4RRH46J2+HP",
          },
        "rating": 3.9,
        "reference": "ChIJyWEHuEmuEmsRm9hTkapTCrk",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 30,
        "vicinity": "King Street Wharf, King St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8712692, "lng": 151.1898651 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86952792010727, "lng": 151.1914560298927 },
                "southwest":
                  { "lat": -33.87222757989272, "lng": 151.1887563701073 },
              },
          },
        "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",
        "name": "Glass Island",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4480,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEAaToCBaHP7Gfdjc740gwIkQcjeUD97NO0TKXJ5IXB0CLGQA6slEpHn4k9LwyhoAzzbSTXJduYyFIkHVmQWGp34NggRxrtOWp7sJf5N6j0ASYlJPmAtWUaaCWnbx_pxdndsopeJ7PYn9kTiMgFcSs-GeipI8hDZgAJswMBnfsO0xWQ-",
              "width": 6720,
            },
          ],
        "place_id": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "plus_code":
          {
            "compound_code": "45HQ+FW Pyrmont, New South Wales",
            "global_code": "4RRH45HQ+FW",
          },
        "rating": 4.1,
        "reference": "ChIJnScuboavEmsRyh-FGxhc3pw",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 90,
        "vicinity": "37 Bank St, Pyrmont",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.85876140000001, "lng": 151.2100004 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85737742010728, "lng": 151.2111319298927 },
                "southwest":
                  { "lat": -33.86007707989272, "lng": 151.2084322701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Junk Lounge",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDaHF9VZFV88tQqFyIgmPlcbCsK-ScCGuUVGh0mTAP4OzWh_0q0T5rPbeC7bas7vD5vC9oS95jtdr4oOnQmhGDAIbHkv4E6UHrQIl0f3XZ-3-RRDjn293w4qQb_BfhbPPO3nokU7npfMfVvCcelWf9WHiWNHT4EEHrFtvuhAWKobTnC",
              "width": 1080,
            },
          ],
        "place_id": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "plus_code":
          {
            "compound_code": "46R6+F2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+F2",
          },
        "price_level": 2,
        "rating": 4.1,
        "reference": "ChIJq9W3HZOvEmsRYtKNTRmq34M",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 63,
        "vicinity": "Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8677035, "lng": 151.2017297 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86634597010728, "lng": 151.2031781298927 },
                "southwest":
                  { "lat": -33.86904562989272, "lng": 151.2004784701072 },
              },
          },
        "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",
        "name": "Sydney New Year's Eve Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 1600,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEDceKHtQ9Hf2eHwnQYXLqrwZ1X2LYVhsfXbqrpIm3_lXZ9apURjAXtVgRVTGxJPD7BtaqR8C7bwaSTakmi0Pazn7g3suj8ZaQRBqheT3KVJDhZ9_GwVInLkWbxqnhivEXs1a-MC_J8XF1SL_5AQ3mAETgiLRQ04116IAEV5vHyIGRsa",
              "width": 2400,
            },
          ],
        "place_id": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "plus_code":
          {
            "compound_code": "46J2+WM Sydney, New South Wales",
            "global_code": "4RRH46J2+WM",
          },
        "rating": 5,
        "reference": "ChIJ__8_hziuEmsR27ucFXECfOg",
        "scope": "GOOGLE",
        "types":
          [
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 5,
        "vicinity": "King Street Wharf 5, 32 The Promenade, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8669866, "lng": 151.2017231 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86563197010727, "lng": 151.2031347298927 },
                "southwest":
                  { "lat": -33.86833162989272, "lng": 151.2004350701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#13B5C7",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "King Street Wharf Darling Harbour",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 3024,
              "html_attributions":
                [
                  '朱品貞',
                ],
              "photo_reference": "Aap_uEDwKXVOjIaCj3LptOdd86B5umsdG7Z3jcvqcpUVLwHS6w8VGEkphgC8-shAx95CrsuXpnKz-XVIixVmgagQHKPH3vSLLqJ6LOAR7Q-_jiyx3ELXD0pm7AARiAtQAMBN9A-oqbtvGbE27yDpvBS1lKe9PCm-dMfrHIIcsS91Qeq2E4b6",
              "width": 4032,
            },
          ],
        "place_id": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "plus_code":
          {
            "compound_code": "46M2+6M Sydney, New South Wales",
            "global_code": "4RRH46M2+6M",
          },
        "rating": 4.4,
        "reference": "ChIJkfDzJ72vEmsR8xtYbk5f0p0",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "convenience_store",
            "bowling_alley",
            "travel_agency",
            "bar",
            "restaurant",
            "food",
            "point_of_interest",
            "store",
            "establishment",
          ],
        "user_ratings_total": 3213,
        "vicinity": "The Promenade, Lime St, Sydney",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.870383, "lng": 151.1979245 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86901092010727, "lng": 151.1991702798927 },
                "southwest":
                  { "lat": -33.87171057989271, "lng": 151.1964706201073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "The Little Snail Restaurant",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 900,
              "html_attributions":
                [
                  'The Little Snail',
                ],
              "photo_reference": "Aap_uEA9aHKkB_6VoFx4VHRSp19PCwnTOuGfpmDYw1NdYNbzncfdjjfEmiiFz-E4tIJ6iGVZjR_bejX6wNr5thJjqlcdQ2PvPyTTo1jGtxk31JG9b6Vd0vu_v4Ep7yutzf3KTzBjYFBIGsYPf3Pj0DptMWPLP7fn33SBT7YmRqDEoGcUsBzw",
              "width": 1350,
            },
          ],
        "place_id": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "plus_code":
          {
            "compound_code": "45HX+R5 Pyrmont, New South Wales",
            "global_code": "4RRH45HX+R5",
          },
        "price_level": 2,
        "rating": 4.5,
        "reference": "ChIJtwapWjeuEmsRcxV5JARHpSk",
        "scope": "GOOGLE",
        "types": ["restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1916,
        "vicinity": "3/50 Murray St, Pyrmont",
      },
    ],
  "status": "OK",
}
    

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</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>
 <result>
  <name>Clearview Sydney Harbour Cruises</name>
  <vicinity>32 The Promenade King Street Wharf 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8676569</lat>
    <lng>151.2017213</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689989</lat>
     <lng>151.2004716</lng>
    </southwest>
    <northeast>
     <lat>-33.8662992</lat>
     <lng>151.2031713</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJNQfwZTiuEmsR1m1x9w0E2V0</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED7hBZqIUaBgFu5q8_xoLMrkWIXUau5D7J2T2fS3HAk4j3aoOp5MQKiujaS8ByzfU9zshp37EMMW6tZe67qLYku2AW-QOVeTbJlyxQ7bqgtSZ_YTo_ES1Xw1bBx8wv8BJYTJZFRzh8enBdH0kLy-oICBpm2fDexARp4CG8Dsxz5bqGA</photo_reference>
   <width>1024</width>
   <height>685</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114394575270272775071&quot;&gt;Clearview Glass Boat Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>49</user_ratings_total>
  <place_id>ChIJNQfwZTiuEmsR1m1x9w0E2V0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Sydney Harbour Lunch Cruise</name>
  <vicinity>5/32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJUbf3iDiuEmsROJxXbhYO7cM</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uED1kwFA2W4XWHpSNZBxiE10JfyZEJrOz8aAPXpR2GbOg0Pc-yPHJYjt6m007fRdSG2PzvsWdZIFE-lny_NRBGUrSzpk9eNVzDp3GLUeV9G0HXcQv7IhEK6vtm_Updlv66bi8S07h3e_lFiHIzFw0TLVfWXjc63Pm94NN1kug7RPJa-6</photo_reference>
   <width>969</width>
   <height>545</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102428257696490257922&quot;&gt;Sydney Harbour Lunch Cruise&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>23</user_ratings_total>
  <place_id>ChIJUbf3iDiuEmsROJxXbhYO7cM</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Sydney Showboats - Dinner Cruise With Show</name>
  <vicinity>32 The Promenade, King Street Wharf, 5, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675883</lat>
    <lng>151.2016452</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8689381</lat>
     <lng>151.2002954</lng>
    </southwest>
    <northeast>
     <lat>-33.8662385</lat>
     <lng>151.2029950</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJjRuIiTiuEmsRCHhYnrWiSok</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAGYIvNdkpJvsbVLPNaMlKukR9jvX48rKMo_TPqbSBRYqvYGExwQM8YvHrz83U7UOJosNI0kay5wV9vZdr9fR12ElFlK5fY3xdoS9N9T08ejq2gLABJJK-Bwl4W2IPw9imoWef1BYMVP07WhXhVOs05a-2A3Qm5fKCRILgUis5pMeCg</photo_reference>
   <width>7360</width>
   <height>4912</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/105311284660389698992&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>119</user_ratings_total>
  <place_id>ChIJjRuIiTiuEmsRCHhYnrWiSok</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</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>
 <result>
  <name>Magistic Cruises</name>
  <vicinity>King Street Wharf, 32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJxRjqYTiuEmsRGebAA_chDLE</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDbALKhgsD-bIG6fWxrermkmKtpIKDHthAySc9EjPEpWDQQtYsSgB4AqLVMArTFCWd04Vb9U51st96ONjtDmWf8KsjKwYtkWxYDFzaY9ZmO2UQpV3rnqjmNHXtIsCdjjwADQbumAkjn5WzBJ-DqlVZs9NmlpLvAY6Jg4DGhduWdewv4</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/103073818292552522030&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>99</user_ratings_total>
  <place_id>ChIJxRjqYTiuEmsRGebAA_chDLE</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>Australian Cruise Group</name>
  <vicinity>6 Cirular Quay, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8609391</lat>
    <lng>151.2098735</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8622889</lat>
     <lng>151.2085237</lng>
    </southwest>
    <northeast>
     <lat>-33.8595893</lat>
     <lng>151.2112233</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJpU8KgUKuEmsRKErVGEaa11w</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECGcpPB2lEO6gIB3QzHeviDhXcG-RV3TXuJPiBHGWbDxnflOhymebF45afUMBIW9r3xC2_gHfiqicV4VnooMJ2-Kwy0YocFXk1_0kkmR1HPV2D9kN9h-yPVK5d6oSPMdmY4MjCut3n8Tv9vt6iu44DDnafb2j78R34EcLQ4iFl0sots</photo_reference>
   <width>2048</width>
   <height>1536</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113088009011192061895&quot;&gt;Keith Bauman&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJpU8KgUKuEmsRKErVGEaa11w</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46Q5+JW</global_code>
   <compound_code>46Q5+JW Sydney, New South Wales</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>
 <result>
  <name>Rhythmboat Cruises</name>
  <vicinity>King Street Wharf, King St, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8686058</lat>
    <lng>151.2018206</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8699997</lat>
     <lng>151.2005721</lng>
    </southwest>
    <northeast>
     <lat>-33.8673000</lat>
     <lng>151.2032718</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>3.9</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJyWEHuEmuEmsRm9hTkapTCrk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEAP5i23uwF3dotBD71Tr0YcEXCHnPOem0CKzKev5YX5dvp63wX7rbLZ3bHNNshIf9P0v3z6GKdF8yJkX3wxXWvzv7EfLwWbwGXYkA-vrXm72ek66P1FlNtNHcbIIyF9HQ1MDXZAhwLcnNJObbk8z9lKmCkBQJCQnkLsGHshZ_ZZCM6L</photo_reference>
   <width>4032</width>
   <height>2269</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104066891898402903288&quot;&gt;Rhythmboat Sydney Harbour Cruises&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>30</user_ratings_total>
  <place_id>ChIJyWEHuEmuEmsRm9hTkapTCrk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+HP</global_code>
   <compound_code>46J2+HP Sydney, New South Wales</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>
 <result>
  <name>Glass Island</name>
  <vicinity>37 Bank St, Pyrmont</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8712692</lat>
    <lng>151.1898651</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8722276</lat>
     <lng>151.1887564</lng>
    </southwest>
    <northeast>
     <lat>-33.8695279</lat>
     <lng>151.1914560</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJnScuboavEmsRyh-FGxhc3pw</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uECzZC-aNaQunm_EMgTFeFyR5-u7E19MSZNuRbK14Tq-GxK-glsLoeqtmdOkA307MesbO6Xqau_7bGM4w5vwxMnPPkc8tEQniNQjgC1M1g9OpMwdd4_8nhmBwOMkzUZk1KU0R9CFYxx7YY5a-HywQSK8kTr1FLXX3y23bSkaDvsgenBr</photo_reference>
   <width>6720</width>
   <height>4480</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117745044320706972021&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>90</user_ratings_total>
  <place_id>ChIJnScuboavEmsRyh-FGxhc3pw</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HQ+FW</global_code>
   <compound_code>45HQ+FW Pyrmont, New South Wales</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>
 <result>
  <name>Junk Lounge</name>
  <vicinity>Level 2, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587614</lat>
    <lng>151.2100004</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600771</lat>
     <lng>151.2084323</lng>
    </southwest>
    <northeast>
     <lat>-33.8573774</lat>
     <lng>151.2111319</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.1</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJq9W3HZOvEmsRYtKNTRmq34M</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEBNQHy0vHfeUWJid28kkZIf4EcgMp50UmkpvhoYPwZJBYImlASnKV4fHlaXTlNQI8H_jUqDpToiMwFOE2XsDpHBdLeZGxpoMq5ThL1gSEMo1zp9U_Pd5jhamilQbpkEeZN_CVeHLAnOX5CG21IF8pda1Zj8IuuENzaKi2BLNQ5TCyYq</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104473997089847488714&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>63</user_ratings_total>
  <place_id>ChIJq9W3HZOvEmsRYtKNTRmq34M</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+F2</global_code>
   <compound_code>46R6+F2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney New Year's Eve Cruises</name>
  <vicinity>King Street Wharf 5, 32 The Promenade, Sydney</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8677035</lat>
    <lng>151.2017297</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8690456</lat>
     <lng>151.2004785</lng>
    </southwest>
    <northeast>
     <lat>-33.8663460</lat>
     <lng>151.2031781</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>5.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJ__8_hziuEmsR27ucFXECfOg</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB3hrLc-p5rV8oczY8fo4vdDdw1c0ZXLzbcgek15WzOon1Qd3WbMfmx994E05fFb5Tt1E60Iux0jaEwGkoy477ru-ZYRD1KUZrfMNw46ciZhnHRD2ZX_nWVYkw2VG_AdEDw1DJ3YQEuDP4EJ5IpsoKianbWyIlmaeuy63TfjdvuFs18</photo_reference>
   <width>2400</width>
   <height>1600</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115281801304517408477&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>5</user_ratings_total>
  <place_id>ChIJ__8_hziuEmsR27ucFXECfOg</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+WM</global_code>
   <compound_code>46J2+WM Sydney, New South Wales</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>
 <result>
  <name>King Street Wharf Darling Harbour</name>
  <vicinity>The Promenade, Lime St, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>bowling_alley</type>
  <type>convenience_store</type>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>store</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8669866</lat>
    <lng>151.2017231</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8683316</lat>
     <lng>151.2004351</lng>
    </southwest>
    <northeast>
     <lat>-33.8656320</lat>
     <lng>151.2031347</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJkfDzJ72vEmsR8xtYbk5f0p0</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEACFUVsoIAR-DdQfFF-95EUG-vLZ4rE0twMHUMam4JM7qPjrfmrVpC80g8CHtMEcimKBxtiGYaEVp7dw12FhfkJw8hZI-bK4Ls9BY3AnvdoUbfVkBvLC7yqT5ly-gMW2ZT8rLc5-mKaZHbWZyZEPgWs84Qd6KPnEKRx6dGNEevYaUlL</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/101920674986627213698&quot;&gt;朱品貞&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>3213</user_ratings_total>
  <place_id>ChIJkfDzJ72vEmsR8xtYbk5f0p0</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46M2+6M</global_code>
   <compound_code>46M2+6M Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#13B5C7</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>
 <result>
  <name>The Little Snail Restaurant</name>
  <vicinity>3/50 Murray St, Pyrmont</vicinity>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8703830</lat>
    <lng>151.1979245</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8717106</lat>
     <lng>151.1964706</lng>
    </southwest>
    <northeast>
     <lat>-33.8690109</lat>
     <lng>151.1991703</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJtwapWjeuEmsRcxV5JARHpSk</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB9EuRqd4be_9HrlUI7lbC5aDokS8UASO_ogA9OFQwEZsFD_jXDwK2Xc2kQm_wDE9TBI_20Na4TcRkgZoers93pw9cJ5RAbedKbUYAvAJz9c-zWKdqRd7pWaOlInQmbJVohI4ZsqbtlhynDqmfgX1SIccGuh066nlxyX7oFvYoLSbNb</photo_reference>
   <width>1350</width>
   <height>900</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/114727320476039103791&quot;&gt;The Little Snail&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1916</user_ratings_total>
  <place_id>ChIJtwapWjeuEmsRcxV5JARHpSk</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH45HX+R5</global_code>
   <compound_code>45HX+R5 Pyrmont, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

    

PlacesNearbySearchResponse

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

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

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

इसमें जगहों का कलेक्शन होता है.

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

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

ज़रूरी है PlacesSearchStatus

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

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

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

जब सेवा, OK< के अलावा कोई दूसरा स्टेटस कोड दिखाती है, तो रिस्पॉन्स ऑब्जेक्ट में एक और error_message फ़ील्ड मौजूद हो सकता है. इस फ़ील्ड में, दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी होती है. यह फ़ील्ड हमेशा नहीं दिखता है. साथ ही, इसके कॉन्टेंट में बदलाव किया जा सकता है.

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

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

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

इसमें एक ऐसा टोकन होता है जिसका इस्तेमाल, ज़्यादा से ज़्यादा 20 अतिरिक्त नतीजे दिखाने के लिए किया जा सकता है. अगर दिखाने के लिए कोई और नतीजा नहीं है, तो next_page_token नहीं दिखाया जाएगा. ज़्यादा से ज़्यादा 60 नतीजे दिखाए जा सकते हैं. next_page_token जारी होने और उसके मान्य होने के बीच थोड़ा समय लगता है.

PlacesSearchStatus

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

  • OK से पता चलता है कि एपीआई अनुरोध पूरा हो गया है.
  • ZERO_RESULTS का मतलब है कि खोज पूरी हो गई है, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब खोज के लिए दूर-दराज़ के इलाके का latlng इस्तेमाल किया गया हो.
  • INVALID_REQUEST से पता चलता है कि एपीआई अनुरोध गलत तरीके से किया गया था. आम तौर पर, ऐसा ज़रूरी क्वेरी पैरामीटर (location या radius) के मौजूद न होने की वजह से होता है.
  • 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" (अमेरिका का राज्य).

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

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

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

ज़रूरी नहीं ज्यामिति

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

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

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

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

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

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

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

इसमें सुझाए गए आइकॉन का यूआरएल होता है. इसमें .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 मीटर) या इससे छोटा. प्लस कोड का इस्तेमाल, मोहल्ले के पतों की जगह किया जा सकता है. ऐसा उन जगहों पर किया जा सकता है जहां मोहल्ले के पते मौजूद नहीं हैं. जैसे, जहां इमारतों के नंबर नहीं हैं या सड़कों के नाम नहीं हैं. ओपन लोकेशन कोड और प्लस कोड देखें.

ज़्यादा जानकारी के लिए, 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 ने अनुवाद किया” स्ट्रिंग जोड़ी जा सकती है.

अन्य नतीजे ऐक्सेस करना

डिफ़ॉल्ट रूप से, हर जवाब में क्वेरी के हिसाब से ज़्यादा से ज़्यादा 20 establishment नतीजे मिलते हैं. हालांकि, हर खोज में ज़्यादा से ज़्यादा 60 नतीजे मिल सकते हैं. इन्हें तीन पेजों में बांटा जाता है. अगर आपकी खोज के नतीजे 20 से ज़्यादा होंगे, तो खोज के जवाब में एक और वैल्यू शामिल होगी — next_page_token. नतीजों का अगला सेट देखने के लिए, next_page_token पैरामीटर की वैल्यू को नए अनुरोध के pagetoken पैरामीटर में पास करें.

  • अगर next_page_token शून्य है या नहीं दिखाया गया है, तो इसका मतलब है कि कोई और नतीजा नहीं है.
  • उसी next_page_token के साथ अनुरोध को फिर से भेजने पर, नतीजों का अगला पेज दिखेगा.
  • pagetoken सेटिंग की वजह से, अन्य सभी पैरामीटर को अनदेखा कर दिया जाएगा.
  • मूल क्वेरी के बाद, दो बार तक नए पेज का अनुरोध किया जा सकता है.
  • next_page_token का इस्तेमाल करके किए गए अनुरोध सहित हर अनुरोध को, इस्तेमाल की सीमाओं के हिसाब से एक अनुरोध के तौर पर गिना जाता है. साथ ही, इसके लिए अलग से शुल्क लिया जाता है.
  • next_page_token जारी होने और उसके मान्य होने के बीच कुछ सेकंड का समय लगता है. अगला पेज उपलब्ध होने से पहले उसका अनुरोध करने पर, INVALID_REQUEST जवाब मिलेगा. next_page_token वाले अनुरोधों के लिए हमेशा शुल्क लिया जाता है.

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

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

नतीजों का अगला सेट देखने के लिए, नई क्वेरी सबमिट की जा सकती है. इसके लिए, next_page_token के नतीजे को pagetoken पैरामीटर में पास करें. उदाहरण के लिए:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY