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

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

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

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

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

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 पैरामीटर के साथ टकराव हो सकता है. इससे अनचाहे नतीजे मिल सकते हैं.

    अगर इस पैरामीटर को शामिल नहीं किया जाता है, तो business_status की वैल्यू 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=cafe&type=cafe या keyword=parking&type=parking) के साथ keyword और type, दोनों को जोड़ने पर 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",
      },
      // ...
    ],
  "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>
 <!-- ... -->
</PlaceSearchResponse>

    

PlacesNearbySearchResponse

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

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

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

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

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

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

ज़रूरी है 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, जिससे किसी अज्ञात गड़बड़ी का पता चलता है.

जगह

Place Search के रिस्पॉन्स में, Place फ़ील्ड का यह सबसेट दिखता है. सभी एट्रिब्यूट, हर तरह की जगह के लिए उपलब्ध नहीं होते. ऐसे फ़ील्ड वापस पाने के लिए जो Place Search से नहीं मिलते, जैसे कि address_components, formatted_phone_number, reviews या website, जगह के बारे में ज़्यादा जानकारी (लेगसी) के अनुरोध में, वापस मिला place_id पास करें. सभी एंडपॉइंट पर फ़ील्ड की उपलब्धता और कीमत के टियर के बारे में जानने के लिए, जगह के लिए डेटा फ़ील्ड (लेगसी) देखें.

फ़ील्ड टाइप ब्यौरा
business_status string अगर जगह कोई कारोबार है, तो इससे पता चलता है कि वह कारोबार चालू है या नहीं: OPERATIONAL, CLOSED_TEMPORARILY या CLOSED_PERMANENTLY. अगर स्टेटस का कोई डेटा मौजूद नहीं है, तो इसे शामिल नहीं किया जाता.
formatted_address string इस जगह का पता, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. टेक्स्ट से खोजें (लेगसी) और Find Place (लेगसी) से मिलता है. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, जगह के बारे में ज़्यादा जानकारी (लेगसी) में address_components का अनुरोध करें.
geometry Geometry इसमें जियोकोड किया गया location शामिल है. इसमें lat और lng कोऑर्डिनेट हैं. साथ ही, इसमें northeast और southwest बाउंड के साथ पसंदीदा viewport शामिल है.
icon string सुझाए गए आइकॉन का यूआरएल, जिसे मैप पर इस नतीजे को दिखाते समय दिखाया जा सकता है.
icon_background_color string जगह की कैटगरी के लिए, डिफ़ॉल्ट हेक्साडेसिमल कलर कोड.
icon_mask_base_uri string सुझाए गए आइकॉन का बेस यूआरएल, जिसमें SVG या PNG फ़ाइल टाइप का एक्सटेंशन शामिल नहीं है.
name string नतीजे का ऐसा नाम जिसे कोई व्यक्ति आसानी से पढ़ सके. establishment नतीजों के लिए, यह वैल्यू आम तौर पर कारोबार का कैननिकल नाम होती है.
opening_hours PlaceOpeningHours कारोबार के खुले होने के समय की जानकारी. Place Search एंडपॉइंट, सिर्फ़ open_now बूलियन सबफ़ील्ड दिखाते हैं. periods और weekday_text के लिए, जगह की जानकारी (लेगसी) में opening_hours का अनुरोध करें.
permanently_closed boolean अब इस्तेमाल नहीं किया जाता: किसी कारोबार के चालू होने की स्थिति देखने के लिए, business_status का इस्तेमाल करें.
photos Array<PlacePhoto> PlacePhoto ऑब्जेक्ट का ऐरे. हर ऑब्जेक्ट में photo_reference, height, width, और html_attributions शामिल होता है. इस्तेमाल के बारे में ज़्यादा जानने के लिए, Place Photos (लेगसी) देखें.
place_id string टेक्स्ट वाला आइडेंटिफ़ायर, जिससे किसी जगह की खास तौर पर पहचान की जाती है. इस आईडी को जगह के बारे में ज़्यादा जानकारी (लेगसी) के अनुरोध के place_id पैरामीटर में पास करें. जगह के आईडी के बारे में खास जानकारी देखें.
plus_code PlusCode अक्षांश और देशांतर निर्देशांकों से मिली, एन्कोड की गई जगह की जानकारी. इसमें global_code और वैकल्पिक compound_code शामिल है.
price_level integer 0 से 4 के स्केल पर, जगह की कीमत का लेवल. इसमें सबसे कम कीमत से लेकर सबसे ज़्यादा कीमत तक शामिल है. price_level देखें.
rating number उपयोगकर्ताओं की सभी समीक्षाओं के आधार पर, जगह की रेटिंग 1.0 से 5.0 के बीच होती है.
reference string अब इस्तेमाल नहीं किया जा सकता: इसके बजाय, place_id का इस्तेमाल करें.
scope string अब इस्तेमाल नहीं किया जाता: इससे place_id के स्कोप का पता चलता है, जो हमेशा GOOGLE होता है. आस-पास की जगहों की जानकारी (लेगसी) से मिला.
types Array<string> नतीजे के बारे में बताने वाली सुविधाओं के टाइप की कलेक्शन. जगह के टाइप (लेगसी) देखें.
user_ratings_total integer इस जगह के लिए, टेक्स्ट वाली या बिना टेक्स्ट वाली समीक्षाओं की कुल संख्या.
vicinity string जगह का आसान पता. इसमें सड़क का नाम, सड़क का नंबर, और मोहल्ले का नाम शामिल होता है. इसमें राज्य या प्रांत, पिन कोड या देश का नाम शामिल नहीं होता. आस-पास की जगहों की जानकारी (लेगसी) से मिला.

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

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

  • अगर 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