टेक्स्ट से खोजें (लेगसी) सुविधा, किसी स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाती है. उदाहरण के लिए, "दिल्ली में पिज़्ज़ा" या "मुंबई के आस-पास जूतों की दुकानें" या "123 मेन स्ट्रीट". यह सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से जगहों की सूची दिखाती है.
टेक्स्ट से खोजें (लेगसी) का इस्तेमाल, ऐसी क्वेरी के लिए नहीं किया जाता है जिनका मतलब साफ़ तौर पर समझ न आए. जैसे:
| क्वेरी का टाइप | उदाहरण |
|---|---|
| एक ही क्वेरी में कई जगहों, सड़कों या शहरों के नाम जैसे कई कॉन्सेप्ट या पाबंदियां शामिल हों | "Market Street San Francisco San Jose Airport" |
| डाक पते के एलिमेंट, Google Maps पर नहीं दिखाए गए हैं |
"C/O जॉन स्मिथ 123 मेन स्ट्रीट" "पी॰ओ॰ बॉक्स 13 सैन फ़्रांसिस्को" |
| कारोबारों, चेन या कैटगरी के नाम के साथ ऐसी जगहों के नाम जोड़ना जहां ये इकाइयां उपलब्ध नहीं हैं | "डैलस, टेक्सस के पास टेस्को" |
| ऐसी क्वेरी जिनके कई मतलब निकल सकते हैं | "चार्जर ड्रॉप-ऑफ़" |
| ऐतिहासिक नाम, जो अब इस्तेमाल नहीं किए जाते | "मिडलसेक्स यूनाइटेड किंगडम" |
| नॉन-जियोस्पेशल एलिमेंट या इंटेंट | "वेंचुरा हार्बर में कितनी नावें हैं?" |
| गैर-आधिकारिक या वैनिटी नेम |
"The Jenga" "The Helter Skelter" |
| अक्षांश और देशांतर निर्देशांक | "37.422131,-122.084801" |
खोज के जवाब में, जगहों की सूची शामिल हो. जवाब में मिली किसी भी जगह के बारे में ज़्यादा जानकारी पाने के लिए, Place Details का अनुरोध भेजा जा सकता है.
टेक्स्ट से खोजें (लेगसी) के अनुरोध
टेक्स्ट से खोजें (लेगसी) का अनुरोध, इस तरह का एचटीटीपी यूआरएल होता है:
https://maps.googleapis.com/maps/api/place/textsearch/output?parameters
जहां output इनमें से कोई भी वैल्यू हो सकती है:
json(सुझाया गया) से पता चलता है कि आउटपुट, JavaScript Object Notation (JSON) में हैxmlसे पता चलता है कि आउटपुट, एक्सएमएल फ़ॉर्मैट में है
खोज का अनुरोध शुरू करने के लिए, कुछ पैरामीटर ज़रूरी होते हैं. यूआरएल में स्टैंडर्ड के तौर पर, सभी पैरामीटर को एंपरसैंड (&) वर्ण का इस्तेमाल करके अलग किया जाता है.
ज़रूरी पैरामीटर
-
क्वेरी
वह टेक्स्ट स्ट्रिंग जिसके लिए खोज करनी है. उदाहरण के लिए: "रेस्टोरेंट" या "123 मेन स्ट्रीट". यह किसी जगह का नाम, पता या कारोबार की कैटगरी होनी चाहिए. किसी अन्य तरह के इनपुट से गड़बड़ियां हो सकती हैं. साथ ही, इस बात की कोई गारंटी नहीं है कि आपको सही नतीजे मिलें. Google Places सेवा, इस स्ट्रिंग के आधार पर संभावित मैच दिखाती है. साथ ही, नतीजों को उनकी प्रासंगिकता के आधार पर क्रम से लगाती है.
-
दायरा
इससे वह दूरी (मीटर में) तय होती है जिसके अंदर जगहों के नतीजे दिखाए जाते हैं.
locationऔरradiusपैरामीटर पास करके, नतीजों को किसी खास सर्कल के हिसाब से बायस किया जा सकता है. ऐसा करने से, Places सेवा को उस सर्कल के अंदर के नतीजे दिखाने के लिए प्राथमिकता मिलती है. हालांकि, तय किए गए इलाके से बाहर के नतीजे अब भी दिखाए जा सकते हैं.खोज के टाइप और अन्य पैरामीटर के आधार पर, दायरा अपने-आप ज़्यादा से ज़्यादा वैल्यू पर सेट हो जाएगा.
- ऑटोकंप्लीट: 50,000 मीटर
-
आस-पास की जगहों की जानकारी:
keywordयाnameके साथ: 50,000 मीटर-
keywordयाnameके बिना-
50,000 मीटर तक, इलाके की डेंसिटी के हिसाब से डाइनैमिक तौर पर अडजस्ट किया जाता है. यह
rankbyपैरामीटर से अलग होता है. -
rankby=distanceका इस्तेमाल करने पर, रेडियस पैरामीटर स्वीकार नहीं किया जाएगा. साथ ही, इससेINVALID_REQUESTदिखेगा.
-
50,000 मीटर तक, इलाके की डेंसिटी के हिसाब से डाइनैमिक तौर पर अडजस्ट किया जाता है. यह
- क्वेरी ऑटोकंप्लीट: 50,000 मीटर
- टेक्स्ट से खोजें: 50,000 मीटर
ज़रूरी नहीं पैरामीटर
-
भाषा
वह भाषा जिसमें नतीजे दिखाए जाएंगे.
- उपलब्ध भाषाओं की सूची देखें. Google अक्सर उन भाषाओं को अपडेट करता रहता है जिनमें यह सुविधा उपलब्ध है. इसलिए, हो सकता है कि इस सूची में पूरी जानकारी शामिल न हो.
-
अगर
languageनहीं दिया गया है, तो एपीआई,Accept-Languageहेडर में बताई गई पसंदीदा भाषा का इस्तेमाल करने की कोशिश करता है. - एपीआई, मोहल्ले का ऐसा पता उपलब्ध कराने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को हासिल करने के लिए, यह स्थानीय भाषा में मोहल्ले के पते दिखाता है. साथ ही, अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा को ध्यान में रखते हुए, उसे ऐसी लिपि में ट्रांसलिट्रेट करता है जिसे उपयोगकर्ता पढ़ सके. अन्य सभी पते, आपकी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं जो पहले कॉम्पोनेंट के लिए चुनी गई है.
- अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
- पसंदीदा भाषा का असर, एपीआई से मिलने वाले नतीजों के सेट और उनके क्रम पर थोड़ा-बहुत पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म का अलग-अलग मतलब निकालता है. जैसे, सड़क के टाइप के लिए इस्तेमाल किए जाने वाले शॉर्ट फ़ॉर्म या समानार्थी शब्द, जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं. उदाहरण के लिए, हंगेरियन भाषा में utca और tér, स्ट्रीट के समानार्थी शब्द हैं.
-
जगह
वह जगह जिसके आस-पास की जगहों की जानकारी हासिल करनी है. इसे
latitude,longitudeके तौर पर सबमिट करना ज़रूरी है.अगरqueryमेंMarket in Barcelonaजैसी कोई जगह साफ़ तौर पर बताई गई है, तोlocationपैरामीटर को बदला जा सकता है. क्वेरी के आस-पास कोटेशन मार्क का इस्तेमाल करने से,locationऔरradiusको दिए गए वेटेज पर भी असर पड़ सकता है. -
maxprice
इससे नतीजे, तय की गई रेंज में मौजूद जगहों तक ही सीमित रहते हैं. मान्य वैल्यू, 0 (सबसे किफ़ायती) से 4 (सबसे महंगी) के बीच होनी चाहिए. इसमें ये भी शामिल हैं. किसी खास वैल्यू से दिखाई गई सटीक रकम, हर इलाके के हिसाब से अलग-अलग होगी.
-
minprice
इससे नतीजे, तय की गई रेंज में मौजूद जगहों तक ही सीमित रहते हैं. मान्य वैल्यू, 0 (सबसे किफ़ायती) से 4 (सबसे महंगी) के बीच होनी चाहिए. इसमें ये भी शामिल हैं. किसी खास वैल्यू से दिखाई गई सटीक रकम, हर इलाके के हिसाब से अलग-अलग होगी.
-
opennow
यह सिर्फ़ उन जगहों की जानकारी दिखाता है जो क्वेरी भेजे जाने के समय खुली होती हैं. अगर आपने अपनी क्वेरी में यह पैरामीटर शामिल किया है, तो Google Places के डेटाबेस में मौजूद ऐसी जगहों की जानकारी नहीं दिखेगी जिनके लिए, कारोबार के खुले होने का समय नहीं बताया गया है.
-
pagetoken
पहले की गई खोज से ज़्यादा से ज़्यादा 20 नतीजे दिखाता है.
pagetokenपैरामीटर सेट करने पर, पहले इस्तेमाल किए गए पैरामीटर के साथ ही खोज की जाएगी. इसमें pagetoken के अलावा, अन्य सभी पैरामीटर को अनदेखा कर दिया जाएगा. -
प्रांत
क्षेत्र का कोड, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू के तौर पर दिया जाता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है.
-
टाइप
यह नतीजों को, तय किए गए टाइप से मैच करने वाली जगहों तक सीमित करता है. सिर्फ़ एक टाइप की जानकारी दी जा सकती है. अगर एक से ज़्यादा टाइप दिए जाते हैं, तो पहली एंट्री के बाद के सभी टाइप को अनदेखा कर दिया जाता है.
-
type=hospital|pharmacy|doctor,type=hospitalहो जाता है type=hospital,pharmacy,doctorको पूरी तरह से अनदेखा किया जाता है
इस्तेमाल किए जा सकने वाले टाइप की सूची देखें.
ध्यान दें: एक ही वैल्यू (keyword=cafe&type=cafeयाkeyword=parking&type=parking) के साथkeywordऔरtype, दोनों को जोड़ने परZERO_RESULTSमिल सकता है. -
टेक्स्ट से खोजें (लेगसी) के उदाहरण
ध्यान दें: इन उदाहरणों में, आपको key को अपनी एपीआई कुंजी से बदलना होगा, ताकि आपके ऐप्लिकेशन में अनुरोध काम कर सके.
बुनियादी उदाहरण
यहां दिए गए उदाहरण में, सिडनी के आस-पास मौजूद रेस्टोरेंट के बारे में खोजा गया है.
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/textsearch/json ?query=restaurants%20in%20Sydney &key=YOUR_API_KEY
अधूरे पते का उदाहरण
यहां दिए गए उदाहरण में, अधूरे पते को खोजने का तरीका बताया गया है. इस मामले में, मोहल्ले के पते में शहर, राज्य या देश का नाम शामिल नहीं है.
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/textsearch/json ?query=123%20main%20street &key=YOUR_API_KEY
JSON
{ "html_attributions": [], "results": [ { "formatted_address": "Main St, Denver, CO 80238, USA", "geometry": { "location": { "lat": 39.782267, "lng": -104.8919341 }, "viewport": { "northeast": { "lat": 39.78361682989273, "lng": -104.8905842701073 }, "southwest": { "lat": 39.78091717010729, "lng": -104.8932839298927 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "Main St", "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI", "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI", "types": ["route"], }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceSearchResponse> <status>OK</status> <result> <name>Main St</name> <type>route</type> <formatted_address>Main St, Denver, CO 80238, USA</formatted_address> <geometry> <location> <lat>39.7822670</lat> <lng>-104.8919341</lng> </location> <viewport> <southwest> <lat>39.7809172</lat> <lng>-104.8932839</lng> </southwest> <northeast> <lat>39.7836168</lat> <lng>-104.8905843</lng> </northeast> </viewport> </geometry> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon> <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference> <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id> <icon_background_color>#7B9EB0</icon_background_color> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceSearchResponse>
जगह के हिसाब से पक्षपात का उदाहरण
नीचे दिए गए उदाहरण में, पिछले उदाहरण में दिए गए अधूरे पते को खोजा गया है. इसमें location और radius पैरामीटर शामिल हैं, ताकि नतीजों को किसी खास इलाके के हिसाब से दिखाया जा सके.
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'HTTP
https://maps.googleapis.com/maps/api/place/textsearch/json ?location=42.3675294%2C-71.186966 &query=123%20main%20street &radius=10000 &key=YOUR_API_KEY
JSON
{ "html_attributions": [], "results": [ { "formatted_address": "123 Main St, Boston, MA 02110, USA", "geometry": { "location": { "lat": 42.3744917, "lng": -71.0634802 }, "viewport": { "northeast": { "lat": 42.37581642989272, "lng": -71.06219107010727 }, "southwest": { "lat": 42.37311677010727, "lng": -71.06489072989272 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "name": "123 Main St", "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA", "plus_code": { "compound_code": "9WFP+QJ Boston, Massachusetts", "global_code": "87JC9WFP+QJ", }, "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA", "types": ["street_address"], }, ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceSearchResponse> <status>OK</status> <result> <name>123 Main St</name> <type>street_address</type> <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address> <geometry> <location> <lat>42.3744917</lat> <lng>-71.0634802</lng> </location> <viewport> <southwest> <lat>42.3731168</lat> <lng>-71.0648907</lng> </southwest> <northeast> <lat>42.3758164</lat> <lng>-71.0621911</lng> </northeast> </viewport> </geometry> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon> <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference> <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id> <plus_code> <global_code>87JC9WFP+QJ</global_code> <compound_code>9WFP+QJ Boston, Massachusetts</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceSearchResponse>
टेक्स्ट से खोजें (लेगसी) के जवाब
खोज के नतीजे, यूआरएल अनुरोध के पाथ में output फ़्लैग से बताए गए फ़ॉर्मैट में दिखाए जाते हैं.
यहां टेक्स्ट से खोजें (लेगसी) के जवाब का उदाहरण दिया गया है.
JSON
{ "html_attributions": [], "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q", "results": [ { "business_status": "OPERATIONAL", "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia", "geometry": { "location": { "lat": -33.8592041, "lng": 151.2132635 }, "viewport": { "northeast": { "lat": -33.85786707010728, "lng": 151.2147093298927 }, "southwest": { "lat": -33.86056672989272, "lng": 151.2120096701072 }, }, }, "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": "Aria Restaurant Sydney", "opening_hours": { "open_now": false }, "photos": [ { "height": 4032, "html_attributions": [ 'Dohyun Kim', ], "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM", "width": 3024, }, ], "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io", "plus_code": { "compound_code": "46R7+88 Sydney, New South Wales, Australia", "global_code": "4RRH46R7+88", }, "price_level": 4, "rating": 4.5, "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io", "types": ["restaurant", "point_of_interest", "food", "establishment"], "user_ratings_total": 1681, }, { "business_status": "OPERATIONAL", "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia", "geometry": { "location": { "lat": -33.8651396, "lng": 151.2104533 }, "viewport": { "northeast": { "lat": -33.86384167010728, "lng": 151.2118993298927 }, "southwest": { "lat": -33.86654132989272, "lng": 151.2091996701073 }, }, }, "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": "Restaurant Hubert", "opening_hours": { "open_now": false }, "photos": [ { "height": 683, "html_attributions": [ 'Ashley Hughes', ], "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q", "width": 1024, }, ], "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ", "plus_code": { "compound_code": "46M6+W5 Sydney, New South Wales, Australia", "global_code": "4RRH46M6+W5", }, "price_level": 3, "rating": 4.6, "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ", "types": ["restaurant", "point_of_interest", "food", "establishment"], "user_ratings_total": 2393, }, // ... ], "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceSearchResponse> <status>OK</status> <result> <name>Aria Restaurant Sydney</name> <type>restaurant</type> <type>point_of_interest</type> <type>food</type> <type>establishment</type> <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address> <geometry> <location> <lat>-33.8592041</lat> <lng>151.2132635</lng> </location> <viewport> <southwest> <lat>-33.8605667</lat> <lng>151.2120097</lng> </southwest> <northeast> <lat>-33.8578671</lat> <lng>151.2147093</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>ChIJdxxU1WeuEmsR11c4fswX-Io</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference> <width>3024</width> <height>4032</height> <html_attribution><a href="https://maps.google.com/maps/contrib/112033760018394328606">Dohyun Kim</a></html_attribution> </photo> <price_level>4</price_level> <user_ratings_total>1681</user_ratings_total> <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id> <plus_code> <global_code>4RRH46R7+88</global_code> <compound_code>46R7+88 Sydney, New South Wales, Australia</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>Restaurant Hubert</name> <type>restaurant</type> <type>point_of_interest</type> <type>food</type> <type>establishment</type> <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address> <geometry> <location> <lat>-33.8651396</lat> <lng>151.2104533</lng> </location> <viewport> <southwest> <lat>-33.8665413</lat> <lng>151.2091997</lng> </southwest> <northeast> <lat>-33.8638417</lat> <lng>151.2118993</lng> </northeast> </viewport> </geometry> <rating>4.6</rating> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon> <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference> <opening_hours> <open_now>false</open_now> </opening_hours> <photo> <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference> <width>1024</width> <height>683</height> <html_attribution><a href="https://maps.google.com/maps/contrib/113719639442868633401">Ashley Hughes</a></html_attribution> </photo> <price_level>3</price_level> <user_ratings_total>2393</user_ratings_total> <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id> <plus_code> <global_code>4RRH46M6+W5</global_code> <compound_code>46M6+W5 Sydney, New South Wales, Australia</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> <!-- ... --> <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token> </PlaceSearchResponse>
PlacesTextSearchResponse
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | 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