स्थान आईडी

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

जगह के आईडी, Google Places के डेटाबेस और Google Maps में मौजूद किसी जगह की खास पहचान करते हैं. स्थान आईडी, इन Maps API के अनुरोधों के लिए स्वीकार किए जाते हैं:

  • जियोकोडिंग एपीआई वेब सेवा में और भौगोलिक जगह पर सेवा देने वाली कंपनी, Maps JavaScript एपीआई में प्लेस आईडी के लिए पता वापस लाया जा रहा है.
  • निर्देश से जुड़ी एपीआई की वेब सेवा, निर्देश पाने की सेवा, Maps JavaScript API में ऑरिजिन, और बीच के रास्ते की जानकारी देना.
  • डिस्टेंस मैट्रिक्स एपीआई वेब सर्विस और डिस्टेंस मैट्रिक्स सर्विस में ऑरिजिन और डेस्टिनेशन के बारे में बताना, Maps JavaScript एपीआई.
  • Places API वेब सेवा में स्थान विवरण पुनर्प्राप्त किया जा रहा है, Android के लिए Places SDK टूल, iOS के लिए Places SDK टूल और Places लाइब्रेरी, JavaScript API.
  • Maps एंबेड एपीआई में स्थान आईडी पैरामीटर का इस्तेमाल कर रहे हैं.
  • Maps यूआरएल में खोज क्वेरी दिखाई जा रही हैं.
  • रोड एपीआई में रफ़्तार की सीमाएं दिखाई जा रही हैं.
  • डेटा-ड्रिवन स्टाइल में बॉर्डर पॉलीगॉन ढूंढना और उन्हें स्टाइल करना.

किसी खास जगह का आईडी ढूंढना

क्या आपको किसी खास जगह का प्लेस आईडी चाहिए? किसी जगह को खोजने और उसका आईडी पाने के लिए, नीचे दिए गए प्लेस आईडी फ़ाइंडर का इस्तेमाल करें:

इसके अलावा, Maps JavaScript API से जुड़े दस्तावेज़ में, जगह का आईडी खोजने वाला टूल भी देखा जा सकता है.

खास जानकारी

जगह का आईडी, टेक्स्ट के लिए आइडेंटिफ़ायर होता है. इससे, किसी जगह की खास पहचान होती है. पहचानकर्ता की लंबाई अलग-अलग हो सकती है. (जगह के आईडी की ज़्यादा से ज़्यादा लंबाई नहीं होती है). उदाहरण:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

जगहों के आईडी, ज़्यादातर जगहों के लिए उपलब्ध हैं. इनमें कारोबार की जगहें, लैंडमार्क, पार्क, और चौराहे शामिल हैं. एक ही जगह या जगह के लिए कई अलग-अलग जगह के आईडी हो सकते हैं. स्थान आईडी समय के साथ बदल सकता है.

आप Places API और कई Google Maps Platform API पर एक ही स्थान आईडी का इस्तेमाल कर सकते हैं. उदाहरण के लिए, आप जगह API, Maps JavaScript API, जियोकोडिंग API, मैप एम्बेड API, और सड़क API में किसी जगह के बारे में बताने के लिए एक ही जगह का आईडी इस्तेमाल करें.

जगह का आईडी इस्तेमाल करके, जगह की जानकारी फिर से पाएं

जगह के आईडी, Google Maps Platform की सेवा की शर्तों के सेक्शन 3.2.3(b) में बताई गई कैश मेमोरी की पाबंदियों से छूट देते हैं. जब आप किसी जगह के लिए प्लेस आईडी की पहचान कर लेते हैं, तो अगली बार उस जगह को देखने के लिए फिर से उस वैल्यू का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, बाद में इस्तेमाल करने के लिए, जगह की जानकारी के आईडी सेव करें देखें.

जगह के आईडी का इस्तेमाल करने का एक आम तरीका है, जगह की जानकारी खोजना (उदाहरण के लिए, Maps JavaScript API में जगहों की जानकारी वाले एपीआई या जगहों की लाइब्रेरी का इस्तेमाल करना), फिर जगह की जानकारी वापस पाने के लिए, जगह की जानकारी वाले आईडी का इस्तेमाल करना. आप जगह का आईडी सेव कर सकते हैं और इसका इस्तेमाल बाद में भी कर सकते हैं. नीचे जगह के आईडी को सेव करने के बारे में पढ़ें.

Places API का उपयोग करने का उदाहरण

जगहों की जानकारी का एपीआई इस्तेमाल करके, जगह खोजें का अनुरोध करके जगह का आईडी देखा जा सकता है.

यहां उदाहरण के तौर पर, ऑस्ट्रेलिया के सिडनी में एक पॉइंट के 1, 500 मीटर के दायरे में मौजूद कई जगहों के नाम और #39;रेस्टोरेंट' के लिए खोज का अनुरोध किया गया है. इसमें #39;cruise' शब्द शामिल है:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY

रिस्पॉन्स में place_id फ़ील्ड में प्लेस आईडी शामिल होता है, जैसा कि इस स्निपेट में दिखाया गया है:

{
  "html_attributions" : [],
  "results" : [
    {
      "geometry" : {
        "location" : {
          "lat" : -33.870775,
          "lng" : 151.199025
        }
      },
      ...
      "place_id" : "ChIJrTLr-GyuEmsRBfy61i59si0",
      ...
    }
  ],
  "status" : "OK"
}

जवाब में दिए गए सभी फ़ील्ड की जानकारी के लिए, जगह की जानकारी खोजें दस्तावेज़ देखें.

अब आप place_id पैरामीटर में स्थान आईडी डालकर, जगह की जानकारी का अनुरोध भेज सकते हैं:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&key=YOUR_API_KEY

स्थान आईडी को बाद में इस्तेमाल करने के लिए सेव करें

जगह के आईडी, Google Maps Platform की सेवा की शर्तों के सेक्शन 3.2.3(a) में बताई गई कैश मेमोरी की पाबंदियों से बाहर रखे गए हैं. इसलिए, आप जगह की जानकारी के आईडी को बाद में इस्तेमाल करने के लिए सेव कर सकते हैं.

सेव किए गए स्थान आईडी रीफ़्रेश हो रहे हैं

अगर स्थान आईडी 12 महीने से ज़्यादा पुराने हैं, तो हम उन्हें रीफ़्रेश करने की सलाह देते हैं. आप जगह की जानकारी का अनुरोध करके बिना किसी शुल्क के प्लेस आईडी को रीफ़्रेश कर सकते हैं. fields पैरामीटर में सिर्फ़ place_id फ़ील्ड की जानकारी दें. इससे जगह की जानकारी - आईडी रीफ़्रेश करने की सुविधा ट्रिगर होगी. SKU. हालांकि, इस अनुरोध में NOT_FOUND स्टेटस कोड भी दिख सकता है. एक रणनीति यह है कि हर जगह के आईडी को दिखाने वाले मूल अनुरोध को सेव किया जाए. अगर किसी जगह का आईडी गलत हो जाता है, तो आप नए नतीजे पाने के लिए फिर से अनुरोध कर सकते हैं. इन नतीजों में आपकी मूल जगह की जानकारी शामिल हो भी सकती है और नहीं भी. अनुरोध शुल्क लिया जाएगा.

स्थान आईडी का इस्तेमाल करते समय गड़बड़ी कोड

INVALID_REQUEST स्टेटस कोड बताता है कि दिया गया स्थान आईडी मान्य नहीं है. अगर जगह का आईडी छोटा किया गया है या किसी दूसरे तरीके से उसमें बदलाव किया गया है और सही जानकारी नहीं है, तो INVALID_REQUEST दिखाया जा सकता है.

NOT_FOUND स्थिति कोड बताता है कि जगह का बताया गया आईडी पुराना है. अगर कोई कारोबार बंद हो जाता है या किसी नई जगह पर चला जाता है, तो उसकी जगह का आईडी पुराना हो सकता है. Google Maps पर बड़े पैमाने पर अपडेट होने की वजह से, जगहों के आईडी बदल सकते हैं. ऐसे मामलों में, किसी जगह को नया स्थान आईडी मिल सकता है और पुराने आईडी से NOT_FOUND जवाब मिलता है.

खास तौर पर, कुछ खास तरह के प्लेस आईडी से कभी-कभी NOT_FOUND जवाब मिल सकता है. इसके अलावा, एपीआई, रिस्पॉन्स में अलग जगह आईडी दे सकता है. इन आईडी टाइप में शामिल हैं:

  • मोहल्ले के ऐसे पते जो Google Maps में मौजूद नहीं हैं और उनके सटीक पते नहीं हैं. उन्हें कई पतों से लगाया गया है.
  • लंबे रास्ते के सेगमेंट, जहां अनुरोध में किसी शहर या इलाके के बारे में भी बताया गया है.
  • चौराहे.
  • ऐसी जगहें जिनके पते का कॉम्पोनेंट subpremise है.

ये आईडी अक्सर एक लंबी स्ट्रिंग के रूप में होते हैं (जगह के आईडी के लिए कोई तय लंबाई नहीं होती). उदाहरण के लिए:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4