जगह ढूंढें (लेगसी)

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

Find Place (लेगसी) अनुरोध, टेक्स्ट इनपुट लेता है और जगह की जानकारी दिखाता है. इनपुट के तौर पर, जगहों से जुड़ा किसी भी तरह का टेक्स्ट डेटा दिया जा सकता है. जैसे, नाम, पता या फ़ोन नंबर. अनुरोध, स्ट्रिंग के तौर पर होना चाहिए. Find Place (लेगसी) अनुरोध में, स्ट्रिंग के अलावा किसी अन्य डेटा का इस्तेमाल करने पर गड़बड़ी होती है. जैसे, अक्षांश/देशांतर निर्देशांक या Plus Code.

Find Place (लेगसी) के अनुरोध

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

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

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

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

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

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

इनपुट

वह टेक्स्ट स्ट्रिंग जिसे खोजना है. यह किसी जगह का नाम, पता या फ़ोन नंबर होना चाहिए. उदाहरण के लिए, "123 मेन स्ट्रीट" या "सिटी हॉल".

inputtype

इनपुट का टाइप. यह textquery या phonenumber में से कोई एक हो सकता है. फ़ोन नंबर, अंतरराष्ट्रीय फ़ॉर्मैट में होने चाहिए. इनमें सबसे पहले प्लस का निशान ("+"), फिर देश का कोड, और उसके बाद फ़ोन नंबर होना चाहिए. ज़्यादा जानकारी के लिए, E.164 आईटीयू सुझाव देखें.

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

फ़ील्ड्स

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

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

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

बेसिक

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

संपर्क करना

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

माहौल

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

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

भाषा

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

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

locationbias

किसी खास इलाके के नतीजे पाने के लिए, दायरा और अक्षांश/देशांतर की जानकारी दें. इसके अलावा, अक्षांश/देशांतर के दो जोड़े भी दिए जा सकते हैं, जो रेक्टैंगल के पॉइंट दिखाते हैं. अगर यह पैरामीटर नहीं दिया गया है, तो एपीआई डिफ़ॉल्ट रूप से आईपी पते के आधार पर नतीजे दिखाता है.

  • आईपी बायस: यह एपीआई को आईपी पते के आधार पर बायस का इस्तेमाल करने का निर्देश देता है. स्ट्रिंग ipbias पास करें (इस विकल्प में कोई अतिरिक्त पैरामीटर नहीं है).
  • सर्कुलर: यह एक स्ट्रिंग है, जिसमें मीटर में त्रिज्या और दशमलव डिग्री में अक्षांश/देशांतर की जानकारी होती है. इस फ़ॉर्मैट का इस्तेमाल करें: circle:radius@lat,lng.
  • Rectangular: यह एक स्ट्रिंग है, जिसमें दशमलव डिग्री में दो अक्षांश/देशांतर जोड़े शामिल होते हैं. ये जोड़े, रेक्टैंगल के दक्षिण/पश्चिम और उत्तर/पूर्व पॉइंट दिखाते हैं. इस फ़ॉर्मैट का इस्तेमाल करें:rectangle:south,west|north,east. ध्यान दें कि पूर्व/पश्चिम की वैल्यू को -180, 180 की रेंज में रैप किया जाता है. साथ ही, उत्तर/दक्षिण की वैल्यू को -90, 90 की रेंज में क्लैंप किया जाता है.

Find Place (लेगसी) के उदाहरण

यहां "म्यूज़ियम ऑफ़ कंटेपररी आर्ट ऑस्ट्रेलिया" के लिए, Find Place (लेगसी) के अनुरोध का उदाहरण दिया गया है. इसमें photos, formatted_address, name, rating, opening_hours, और geometry फ़ील्ड शामिल हैं:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

यहां "मंगोलियन ग्रिल" के लिए, जगह ढूंढें (लेगसी) के अनुरोध का उदाहरण दिया गया है. इसमें locationbias पैरामीटर का इस्तेमाल करके, दिए गए निर्देशांकों से 2,000 मीटर के दायरे में मौजूद नतीजे दिखाए गए हैं:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

यहां किसी फ़ोन नंबर के लिए, Find Place (लेगसी) के अनुरोध का उदाहरण दिया गया है. ध्यान दें कि अंतरराष्ट्रीय कॉल प्रीफ़िक्स "+" को %2B में कोड किया गया है, ताकि यह अनुरोध एक मान्य यूआरएल हो. अगर + प्रीफ़िक्स को एन्कोड नहीं किया जाता है, तो सर्वर पर इसे स्पेस के तौर पर डिकोड किया जाएगा. इससे, फ़ोन नंबर की अमान्य खोज होगी.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Find Place (लेगसी) के जवाब

Find Place (लेगसी) के जवाब में सिर्फ़ वे डेटा टाइप शामिल होते हैं जिन्हें fields पैरामीटर और html_attributions का इस्तेमाल करके तय किया गया था. यहां दिए गए उदाहरण में, "म्यूज़ियम ऑफ़ कंटेंपररी आर्ट ऑस्ट्रेलिया" के लिए, Find Place (लेगसी) के अनुरोध का जवाब दिखाया गया है. इसमें formatted_address, geometry, name, opening_hours, photos, rating फ़ील्ड शामिल हैं.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

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

इसमें जगह के उम्मीदवारों का कलेक्शन होता है.

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

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

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

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

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

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

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

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

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 निर्देशांक और पसंदीदा viewport के साथ-साथ northeast और southwest बाउंड शामिल हैं.
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 जगह का आसान पता. इसमें सड़क का नाम, सड़क का नंबर, और मोहल्ले का नाम शामिल होता है. इसमें राज्य या प्रांत, पिन कोड या देश का नाम शामिल नहीं होता. आस-पास की जगहों की जानकारी (लेगसी) से मिला.