आस-पास की जगहों की जानकारी (लेगसी) की मदद से, किसी तय इलाके में मौजूद जगहें खोजी जा सकती हैं. कीवर्ड डालकर या जिस तरह की जगह खोजी जा रही है उसकी जानकारी देकर, खोज के अनुरोध को बेहतर बनाया जा सकता है.
आस-पास की जगहों की जानकारी (लेगसी) के अनुरोध
आस-पास की जगहों की जानकारी (लेगसी) का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:
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 मीटर
- टेक्स्ट से खोजें: 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><a href="https://maps.google.com/maps/contrib/112582655193348962755">A Google User</a></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><a href="https://maps.google.com/maps/contrib/109764923610545394994">A Google User</a></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 देखें. |
|
ज़रूरी नहीं | स्ट्रिंग |
जब सेवा |
|
ज़रूरी नहीं | Array<string> |
जब सेवा, अनुरोध की खास जानकारी के बारे में ज़्यादा जानकारी दिखाती है, तो रिस्पॉन्स ऑब्जेक्ट में एक और |
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें एक टोकन होता है, जिसका इस्तेमाल करके ज़्यादा से ज़्यादा 20 अतिरिक्त नतीजे दिखाए जा सकते हैं. अगर दिखाने के लिए कोई और नतीजा नहीं है, तो next_page_token नहीं दिखाया जाएगा. ज़्यादा से ज़्यादा 60 नतीजे दिखाए जा सकते हैं. next_page_token जारी होने और उसके मान्य होने के बीच थोड़ा समय लगता है. |
PlacesSearchStatus
सेवा से मिले स्टेटस कोड.
OK, जिससे पता चलता है कि एपीआई अनुरोध पूरा हो गया है.-
ZERO_RESULTS, जिससे पता चलता है कि खोज पूरी हो गई है, लेकिन कोई नतीजा नहीं मिला. ऐसा तब हो सकता है, जब खोज के लिए किसी दूर-दराज़ की जगह परlatlngपास किया गया हो. -
INVALID_REQUEST, जिससे पता चलता है कि एपीआई अनुरोध गलत था. आम तौर पर, ऐसा ज़रूरी क्वेरी पैरामीटर (locationयाradius) मौजूद न होने की वजह से होता है. -
OVER_QUERY_LIMIT, जिसमें इनमें से कोई जानकारी शामिल हो:- आपने क्यूपीएस की सीमाएं पार कर ली हैं.
- आपके खाते के लिए बिलिंग की सुविधा चालू नहीं की गई है.
- हर महीने मिलने वाला 200 डॉलर का क्रेडिट या इस्तेमाल की तय सीमा खत्म हो गई है.
- पेमेंट का दिया गया तरीका अब मान्य नहीं है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है.
-
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