टेक्स्ट से खोजें (लेगसी)

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

टेक्स्ट से खोजें (लेगसी) सुविधा, किसी स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाती है. उदाहरण के लिए, "दिल्ली में पिज़्ज़ा" या "मुंबई के आस-पास जूतों की दुकानें" या "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 मीटर

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

  • भाषा

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

    • उपलब्ध भाषाओं की सूची देखें. 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>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</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>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</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 देखें.

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

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

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

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

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

इसमें एक टोकन होता है, जिसका इस्तेमाल करके ज़्यादा से ज़्यादा 20 अतिरिक्त नतीजे दिखाए जा सकते हैं. अगर दिखाने के लिए कोई और नतीजा नहीं है, तो next_page_token नहीं दिखेगा. ज़्यादा से ज़्यादा 60 नतीजे दिखाए जा सकते हैं. next_page_token जारी होने और उसके मान्य होने के बीच थोड़ा समय लगता है.

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 कोऑर्डिनेट हैं. साथ ही, इसमें 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