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

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

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

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

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

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

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

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

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

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

  • इनपुट

    वह टेक्स्ट स्ट्रिंग जिसमें खोजना है. उदाहरण के लिए: "रेस्टोरेंट" या "123 मेन स्ट्रीट". यह किसी जगह का नाम, पता या कारोबारों की कैटगरी होनी चाहिए. किसी अन्य तरह का इनपुट देने पर गड़बड़ियां हो सकती हैं. साथ ही, यह ज़रूरी नहीं है कि आपको मान्य नतीजे मिलें. Places API, इस स्ट्रिंग के आधार पर संभावित मैच दिखाएगा. साथ ही, नतीजों को इस आधार पर क्रम में लगाएगा कि वे कितने काम के हैं.

  • inputtype

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

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

  • फ़ील्ड्स

    ध्यान दें: जगह के लिए खोज करने के अनुरोध और जगह के बारे में ज़्यादा जानकारी पाने के अनुरोध पर, एक जैसे फ़ील्ड नहीं मिलते. जगह के लिए खोज के अनुरोधों से, उन फ़ील्ड का सबसेट मिलता है जो जगह के बारे में ज़्यादा जानकारी के अनुरोधों से मिलता है. अगर आपको जो फ़ील्ड चाहिए वह Place Search के जवाब में नहीं मिलता है, तो Place Search का इस्तेमाल करके place_id पाएं. इसके बाद, उस Place ID का इस्तेमाल करके, जगह के बारे में ज़्यादा जानकारी पाने का अनुरोध करें. जगह के बारे में खोज करने के अनुरोध में उपलब्ध न होने वाले फ़ील्ड के बारे में ज़्यादा जानने के लिए, 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 (deprecated), 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.
    • आयताकार: यह एक स्ट्रिंग होती है. इसमें दशमलव डिग्री में दो अक्षांश/देशांतर के जोड़े दिए जाते हैं. ये जोड़े, आयत के दक्षिण/पश्चिम और उत्तर/पूर्व बिंदुओं को दिखाते हैं. इस फ़ॉर्मैट का इस्तेमाल करें:rectangle:south,west|north,east. ध्यान दें कि पूरब/पश्चिम की वैल्यू को -180 से 180 की रेंज में और उत्तर/दक्षिण की वैल्यू को -90 से 90 की रेंज में शामिल किया जाता है.

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

यहां "Museum of Contemporary Art Australia" के लिए, 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

यहां "Mongolian Grill" के लिए, जगह ढूंढने (लेगसी) के अनुरोध का उदाहरण दिया गया है. इसमें 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_id पाएं. इसके बाद, उस Place ID का इस्तेमाल करके, Place Details का अनुरोध करें.

ज़्यादा जानकारी के लिए, जगह देखें.
ज़रूरी है 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 से पता चलता है कि कोई गड़बड़ी हुई है.

जगह

किसी जगह की जानकारी देने वाले एट्रिब्यूट. सभी तरह की जगहों के लिए, सभी एट्रिब्यूट उपलब्ध नहीं होंगे.

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

यह एक कैटगरी है, जिसमें इस पते पर लागू होने वाले अलग-अलग कॉम्पोनेंट शामिल होते हैं.

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

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

जगह के पते को adr microformat में दिखाया गया है.

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

अगर कोई जगह कारोबार है, तो इससे उसकी चालू स्थिति के बारे में पता चलता है. अगर कोई डेटा मौजूद नहीं है, तो business_status नहीं दिखाया जाता.

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार, कर्बसाइड पिकअप की सुविधा देता है या नहीं.
ज़रूरी नहीं PlaceOpeningHours

इसमें अगले सात दिनों के लिए काम के घंटे शामिल होते हैं. इनमें आज के दिन के घंटे भी शामिल हैं. यह समयावधि, अनुरोध की तारीख को आधी रात से शुरू होती है और छह दिन बाद रात 11:59 बजे खत्म होती है. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.

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

ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार डिलीवरी की सुविधा देता है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार में, अंदर या बाहर बैठने की सुविधा है या नहीं.

ज़रूरी नहीं PlaceEditorialSummary

इसमें जगह की खास जानकारी होती है. खास जानकारी में टेक्स्ट के रूप में खास जानकारी शामिल होती है. साथ ही, अगर लागू हो, तो इसमें इनके लिए भाषा कोड भी शामिल होता है. जवाब में दिए गए टेक्स्ट को उसी तरह से दिखाना होगा जैसा वह है. इसमें बदलाव नहीं किया जा सकता.

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

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

इस स्ट्रिंग में, इस जगह का पता होता है. इसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

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

फ़ॉर्मैट किया गया पता, लॉजिक के हिसाब से एक या उससे ज़्यादा पते के कॉम्पोनेंट से बना होता है. उदाहरण के लिए, "111 8th Avenue, New York, NY" पते में ये कॉम्पोनेंट शामिल हैं: "111" (सड़क का नंबर), "8th Avenue" (रास्ता), "New York" (शहर), और "NY" (अमेरिका का राज्य).

फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें. इसके बजाय, आपको पते के अलग-अलग कॉम्पोनेंट का इस्तेमाल करना चाहिए. एपीआई के जवाब में, फ़ॉर्मैट किए गए पते वाले फ़ील्ड के साथ-साथ ये कॉम्पोनेंट भी शामिल होते हैं.

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

इसमें जगह का फ़ोन नंबर, स्थानीय फ़ॉर्मैट में होता है.

ज़रूरी नहीं Geometry

इसमें जगह की जानकारी और जगह के लिए व्यूपोर्ट होता है.

ज़्यादा जानकारी के लिए, Geometry पर जाएं.
ज़रूरी नहीं स्ट्रिंग

इसमें सुझाए गए आइकॉन का यूआरएल होता है. इस आइकॉन को मैप पर यह नतीजा दिखाते समय, उपयोगकर्ता को दिखाया जा सकता है.

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

इसमें जगह की कैटगरी के लिए डिफ़ॉल्ट एचईएक्स कलर कोड होता है.
ज़रूरी नहीं स्ट्रिंग

इसमें सुझाए गए आइकॉन का यूआरएल होता है. इसमें .svg या .png फ़ाइल टाइप एक्सटेंशन शामिल नहीं होता.

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

इसमें जगह का फ़ोन नंबर, अंतरराष्ट्रीय फ़ॉर्मैट में होता है. अंतरराष्ट्रीय फ़ॉर्मैट में देश का कोड शामिल होता है. साथ ही, इसके पहले प्लस (+) का निशान होता है. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में मौजूद Google के ऑफ़िस का international_phone_number +61 2 9374 4000 है.

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

इसमें, दिखाए गए नतीजे का ऐसा नाम होता है जिसे आसानी से पढ़ा जा सकता है. establishment नतीजों के लिए, यह आम तौर पर कारोबार का कैननिकल नाम होता है.

ज़रूरी नहीं PlaceOpeningHours

इसमें कारोबार के खुले रहने का सामान्य समय शामिल होता है.

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

ज़रूरी नहीं बूलियन

कारोबारों के चालू होने की स्थिति जानने के लिए, business_status का इस्तेमाल करें.

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

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

ज़्यादा जानकारी के लिए, PlacePhoto देखें.
ज़रूरी नहीं स्ट्रिंग

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

ज़रूरी नहीं PlusCode

यह अक्षांश और देशांतर के कोऑर्डिनेट से मिला, एन्कोड किया गया जगह का रेफ़रंस होता है. यह किसी जगह को दिखाता है: 1/8000 डिग्री x 1/8000 डिग्री (भूमध्य रेखा पर करीब 14 मीटर x 14 मीटर) या इससे छोटा. Plus Codes का इस्तेमाल, उन जगहों पर मोहल्ले के पतों की जगह किया जा सकता है जहां वे मौजूद नहीं हैं. जैसे, जहां इमारतों के नंबर नहीं होते या सड़कों के नाम नहीं होते. ओपन लोकेशन कोड और प्लस कोड देखें.

ज़्यादा जानकारी के लिए, PlusCode पर जाएं.
ज़रूरी नहीं संख्या

जगह के किराये का लेवल, 0 से 4 के स्केल पर. किसी वैल्यू से मिलने वाली सटीक रकम, इलाके के हिसाब से अलग-अलग होगी. कीमत के लेवल को इस तरह से समझा जाता है:

  • 0 मुफ़्त
  • 1 सस्ता
  • 2 सामान्य
  • 3 महंगा
  • 4 बहुत महंगा
ज़रूरी नहीं संख्या

इसमें जगह की रेटिंग होती है. यह 1.0 से 5.0 तक होती है. यह रेटिंग, उपयोगकर्ताओं की कुल समीक्षाओं के आधार पर तय की जाती है.

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

इससे पता चलता है कि जगह पर बुकिंग की सुविधा उपलब्ध है या नहीं.
ज़रूरी नहीं Array<PlaceReview>

ज़्यादा से ज़्यादा पांच समीक्षाओं का JSON कलेक्शन. डिफ़ॉल्ट रूप से, समीक्षाओं को इस क्रम में लगाया जाता है कि वे कितनी काम की हैं. सॉर्ट करने की सुविधा को कंट्रोल करने के लिए, reviews_sort अनुरोध पैरामीटर का इस्तेमाल करें.

  • most_relevant (डिफ़ॉल्ट) के लिए, समीक्षाओं को काम के हिसाब से क्रम में लगाया जाता है. सेवा, नतीजों को इस तरह से व्यवस्थित करेगी कि पसंदीदा भाषा में लिखी गई समीक्षाएं सबसे पहले दिखें.
  • newest के लिए, समीक्षाओं को समय के हिसाब से क्रम में लगाया जाता है. पसंदीदा भाषा से, क्रम पर कोई असर नहीं पड़ता.

Google का सुझाव है कि उपयोगकर्ताओं को यह बताया जाए कि नतीजे most_relevant या newest के हिसाब से क्रम में लगाए गए हैं.

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

ज़रूरी नहीं स्ट्रिंग
ज़रूरी नहीं Array<PlaceOpeningHours>

इसमें अगले सात दिनों के लिए एंट्री की एक सीरीज़ होती है. इसमें कारोबार के खुले होने के दूसरे समय की जानकारी भी शामिल होती है. कारोबार के खुले होने का दूसरा समय, कारोबार के खुले होने के मुख्य समय से अलग होता है. उदाहरण के लिए, कोई रेस्टोरेंट ड्राइव-थ्रू (कार से उतरे बिना ऑर्डर देना) या डिलीवरी के लिए उपलब्ध समय को, कारोबार के खुलने के दूसरे समय के तौर पर सेट कर सकता है. इस फ़ील्ड से type सब-फ़ील्ड की वैल्यू अपने-आप भर जाती है. यह वैल्यू, कारोबार के खुले होने के समय के टाइप की पहले से तय की गई सूची से ली जाती है. जैसे, DRIVE_THROUGH, PICKUP या TAKEOUT. यह सूची, जगह के टाइप के हिसाब से तय की जाती है. इस फ़ील्ड में, उन तारीखों के लिए सेट किए गए सभी घंटों का special_days सब-फ़ील्ड शामिल होता है जिनके लिए खास घंटे सेट किए गए हैं.

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

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर बीयर मिलती है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर नाश्ता मिलता है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर ब्रंच परोसा जाता है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर डिनर परोसा जाता है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि क्या इस जगह पर लंच परोसा जाता है.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर शाकाहारी खाना मिलता है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह पर वाइन मिलती है या नहीं.
ज़रूरी नहीं बूलियन

इससे पता चलता है कि कारोबार में खाना पैक कराने की सुविधा उपलब्ध है या नहीं.
ज़रूरी नहीं Array<string>

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

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

इसमें इस जगह के लिए, Google के आधिकारिक पेज का यूआरएल होता है. यह Google के मालिकाना हक वाला पेज होगा. इसमें जगह के बारे में सबसे अच्छी जानकारी उपलब्ध होगी. ऐप्लिकेशन को इस पेज को लिंक करना होगा या इसे एम्बेड करना होगा. ऐसा उस स्क्रीन पर करना होगा जिस पर उपयोगकर्ता को जगह के बारे में ज़्यादा जानकारी वाले नतीजे दिखते हैं.

ज़रूरी नहीं संख्या

इस जगह के लिए, टेक्स्ट के साथ या बिना टेक्स्ट वाली समीक्षाओं की कुल संख्या.

ज़रूरी नहीं संख्या

इसमें यह जानकारी होती है कि इस जगह का मौजूदा टाइमज़ोन, यूटीसी से कितने मिनट आगे या पीछे है. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में डेलाइट सेविंग टाइम के दौरान यह 660 (+11 घंटे यूटीसी से) होगा. वहीं, कैलिफ़ोर्निया में डेलाइट सेविंग टाइम के बाहर यह -480 (-8 घंटे यूटीसी से) होगा.

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

कारोबार की जगह (types:["establishment", ...]) सिर्फ़ नतीजों के लिए) के लिए, vicinity फ़ील्ड में जगह का आसान पता होता है. इसमें सड़क का नाम, सड़क का नंबर, और इलाका शामिल होता है. हालांकि, इसमें प्रांत/राज्य, पिन कोड या देश शामिल नहीं होता है.

अन्य सभी नतीजों के लिए, vicinity फ़ील्ड में, राजनैतिक (types:["political", ...]) तौर पर सबसे छोटे क्षेत्र का नाम होता है. यह क्षेत्र, नतीजे के पते में मौजूद होता है.

इस कॉन्टेंट को जैसा है वैसा ही पढ़ा जाना चाहिए. फ़ॉर्मैट किए गए पते को प्रोग्राम के हिसाब से पार्स न करें.

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

इस जगह की आधिकारिक वेबसाइट, जैसे कि किसी कारोबार का होम पेज.

ज़रूरी नहीं बूलियन

इससे पता चलता है कि जगह में व्हीलचेयर लाने-ले जाने की सुविधा वाला दरवाज़ा है या नहीं.

PlaceEditorialSummary

इसमें जगह की खास जानकारी होती है. खास जानकारी में टेक्स्ट के रूप में खास जानकारी दी जाती है. साथ ही, अगर लागू हो, तो इसमें भाषा कोड भी शामिल होता है. जवाब के टेक्स्ट को उसी रूप में दिखाना होगा. इसमें बदलाव नहीं किया जा सकता.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं स्ट्रिंग

पिछले फ़ील्ड की भाषा. ऐसा हो सकता है कि यह हमेशा मौजूद न हो.
ज़रूरी नहीं स्ट्रिंग

जगह के बारे में, टेक्स्ट के रूप में दी गई खास जानकारी. यह जानकारी न तो बहुत छोटी होती है और न ही बहुत बड़ी.

PlaceOpeningHours

किसी जगह के खुले होने के समय की जानकारी देने वाला ऑब्जेक्ट.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं बूलियन

बूलियन वैल्यू, जिससे यह पता चलता है कि जगह अभी खुली है या नहीं.

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

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

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

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

यह अगले सात दिनों के लिए, ज़्यादा से ज़्यादा सात एंट्री वाला एक कलेक्शन होता है.

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

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

यह एक टाइप स्ट्रिंग है. इसका इस्तेमाल, कारोबार के दूसरे समय की जानकारी के टाइप की पहचान करने के लिए किया जाता है. उदाहरण के लिए, DRIVE_THROUGH, HAPPY_HOUR, DELIVERY, TAKEOUT, KITCHEN, BREAKFAST, LUNCH, DINNER, BRUNCH, PICKUP, SENIOR_HOURS. इसे सिर्फ़ secondary_opening_hours के लिए सेट किया जाता है.

weekday_text

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

यह स्ट्रिंग का एक ऐसा कलेक्शन होता है जिसमें किसी जगह के खुलने और बंद होने के समय के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

PlaceOpeningHoursPeriod

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है PlaceOpeningHoursPeriodDetail

इसमें दिन और समय के ऑब्जेक्ट का एक पेयर होता है. इससे पता चलता है कि जगह कब खुलती है.

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

ज़रूरी नहीं PlaceOpeningHoursPeriodDetail

इसमें दिन और समय के ऑब्जेक्ट का एक ऐसा पेयर शामिल हो सकता है जिससे यह पता चलता है कि जगह कब बंद होती है. अगर कोई जगह हमेशा खुली रहती है, तो जवाब में 'बंद होने का समय' सेक्शन नहीं दिखेगा. क्लाइंट, हमेशा खुले रहने की सुविधा के लिए इस बात पर भरोसा कर सकते हैं कि इसे खुले रहने की अवधि के तौर पर दिखाया जाएगा. इसमें दिन की वैल्यू 0 और समय की वैल्यू 0000 होगी. साथ ही, इसमें close नहीं होगा.

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

PlaceSpecialDay

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी नहीं स्ट्रिंग

किसी जगह के स्थानीय टाइमज़ोन के हिसाब से, RFC3339 फ़ॉर्मैट में तारीख. उदाहरण के लिए, 2010-12-31.

ज़रूरी नहीं बूलियन

अगर इस दिन के लिए, कारोबार के खुले होने का समय सामान्य से अलग है, तो यह वैल्यू सही होती है. अगर true है, तो इसका मतलब है कि इस दिन के लिए कम से कम एक अपवाद है. अपवादों की वजह से, current_opening_hours और secondary_opening_hours के सब-फ़ील्ड में अलग-अलग वैल्यू दिखती हैं. जैसे, periods, weekday_text, open_now. अपवाद, समय के लिए लागू होते हैं. साथ ही, समय का इस्तेमाल अन्य फ़ील्ड जनरेट करने के लिए किया जाता है.

PlaceOpeningHoursPeriodDetail

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

यह 0 से 6 तक की कोई संख्या होती है. यह हफ़्ते के दिनों के हिसाब से होती है. इसकी शुरुआत रविवार से होती है. उदाहरण के लिए, 2 का मतलब मंगलवार है.

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

इसमें 24 घंटे वाले hhmm फ़ॉर्मैट में दिन का समय शामिल हो सकता है. वैल्यू 0000–2359 की रेंज में होनी चाहिए. समय की जानकारी, जगह के टाइम ज़ोन के हिसाब से दी जाएगी.

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

किसी जगह के स्थानीय टाइमज़ोन के हिसाब से, RFC3339 फ़ॉर्मैट में तारीख. उदाहरण के लिए, 2010-12-31.

ज़रूरी नहीं बूलियन

अगर सात दिनों के कटऑफ़ की वजह से, किसी अवधि को छोटा कर दिया गया है, तो यह वैल्यू true होती है. इसमें अवधि, अनुरोध की तारीख को आधी रात से पहले शुरू होती है और/या आखिरी दिन आधी रात को या उसके बाद खत्म होती है. इस प्रॉपर्टी से पता चलता है कि कारोबार के खुलने या बंद होने की अवधि, सात दिनों की कटऑफ़ अवधि से आगे बढ़ सकती है.

PlacePhoto

किसी जगह की फ़ोटो. फ़ोटो को Place Photo API का इस्तेमाल करके ऐक्सेस किया जा सकता है. इसके लिए, इस पैटर्न में यूआरएल का इस्तेमाल करें: 

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

ज़्यादा जानकारी के लिए, जगह की फ़ोटो देखें.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है संख्या

फ़ोटो की ऊंचाई.
ज़रूरी है Array<string>

फ़ोटो के लिए एचटीएमएल एट्रिब्यूशन.
ज़रूरी है स्ट्रिंग

यह एक स्ट्रिंग है. इसका इस्तेमाल, फ़ोटो का अनुरोध करते समय फ़ोटो की पहचान करने के लिए किया जाता है.

ज़रूरी है संख्या

फ़ोटो की चौड़ाई.

PlaceReview

किसी व्यक्ति ने जगह की समीक्षा सबमिट की है.

फ़ील्ड ज़रूरी है टाइप ब्यौरा
ज़रूरी है स्ट्रिंग

समीक्षा सबमिट करने वाले व्यक्ति का नाम. पहचान छिपाकर की गई समीक्षाओं को "Google उपयोगकर्ता" के तौर पर दिखाया जाता है.

ज़रूरी है संख्या

इस जगह के लिए उपयोगकर्ता की कुल रेटिंग. यह एक पूर्णांक है, जो 1 से 5 के बीच होता है.

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

समीक्षा को टेक्स्ट में सबमिट करने का समय, मौजूदा समय के हिसाब से.

ज़रूरी है संख्या

समीक्षा सबमिट करने का समय. इसे 1 जनवरी, 1970 को 00:00:00 यूटीसी से लेकर अब तक के सेकंड की संख्या के हिसाब से मापा जाता है.

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

अगर उपयोगकर्ता की Google Maps Local Guides प्रोफ़ाइल उपलब्ध है, तो उसका यूआरएल.

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

यह एक आईईटीएफ़ भाषा कोड है. इससे पता चलता है कि जवाब में दी गई समीक्षा किस भाषा में है. इस फ़ील्ड में सिर्फ़ मुख्य भाषा का टैग होता है. इसमें देश या इलाके के बारे में बताने वाला सेकंडरी टैग नहीं होता. उदाहरण के लिए, अंग्रेज़ी में लिखी गई सभी समीक्षाओं को 'en' के तौर पर टैग किया जाता है, न कि 'en-AU' या 'en-UK' के तौर पर. इसी तरह, अन्य भाषाओं में लिखी गई समीक्षाओं को भी टैग किया जाता है. अगर सिर्फ़ रेटिंग दी गई है और समीक्षा का टेक्स्ट नहीं है, तो यह फ़ील्ड खाली होता है.

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

यह एक आईईटीएफ़ भाषा कोड है. इससे समीक्षा की मूल भाषा के बारे में पता चलता है. अगर समीक्षा का अनुवाद किया गया है, तो original_language != language. इस फ़ील्ड में सिर्फ़ मुख्य भाषा का टैग होता है. इसमें देश या इलाके की जानकारी देने वाला सेकंडरी टैग नहीं होता. उदाहरण के लिए, अंग्रेज़ी में लिखी गई सभी समीक्षाओं को 'en' के तौर पर टैग किया जाता है, न कि 'en-AU' या 'en-UK' वगैरह के तौर पर.अगर सिर्फ़ रेटिंग दी गई है और समीक्षा का टेक्स्ट नहीं है, तो यह फ़ील्ड खाली होता है.

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

अगर उपलब्ध हो, तो उपयोगकर्ता की प्रोफ़ाइल फ़ोटो का यूआरएल.

text

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

उपयोगकर्ता की समीक्षा. Google Places पर किसी जगह की समीक्षा करते समय, टेक्स्ट वाली समीक्षाएं देना ज़रूरी नहीं है. इसलिए, यह फ़ील्ड खाली हो सकता है. ध्यान दें कि इस फ़ील्ड में बेसिक एचटीएमएल मार्कअप शामिल हो सकता है. उदाहरण के लिए, एंटिटी रेफ़रंस &amp;, ऐंड सिंबल को दिखा सकता है.

ज़रूरी नहीं बूलियन

बूलियन वैल्यू से पता चलता है कि समीक्षा का अनुवाद, उसकी मूल भाषा से किया गया है या नहीं. अगर किसी समीक्षा का अनुवाद किया गया है, तो Google का सुझाव है कि आप अपने उपयोगकर्ताओं को इस बारे में बताएं. इसके लिए, आपको true वैल्यू का इस्तेमाल करना होगा. उदाहरण के लिए, समीक्षा में "Google ने अनुवाद किया" स्ट्रिंग जोड़ी जा सकती है.