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

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 पैरामीटर का इस्तेमाल करें. उदाहरण के लिए: 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 -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'

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 -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'

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 -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'

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 फ़ील्ड शामिल हैं.

{
  "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 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

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 पास करें. सभी एंडपॉइंट पर फ़ील्ड की उपलब्धता और कीमत के टियर के बारे में जानने के लिए, जगह के लिए डेटा फ़ील्ड (लेगसी) देखें.