जगह के आईडी, Google Places के डेटाबेस और Google Maps पर मौजूद किसी जगह की खास तौर पर पहचान करते हैं. जगह के आईडी, Maps के इन एपीआई के अनुरोधों में स्वीकार किए जाते हैं:
- Geocoding API और Maps JavaScript API की जियोकोडिंग सेवा में, जगह के आईडी के लिए पता पाना.
- Routes API और Directions API (लेगसी) के साथ-साथ, Directions Service, Maps JavaScript API (लेगसी) में, ऑरिजिन, डेस्टिनेशन, और बीच में पड़ने वाले वेपॉइंट की जानकारी देना.
- Routes API और Distance Matrix API (लेगसी) और Distance Matrix Service, Maps JavaScript API (लेगसी) में, ऑरिजिन और डेस्टिनेशन की जानकारी देना.
- Places API (नया), Places SDK for Android (नया), Places SDK for iOS (नया), और Places लाइब्रेरी में जगह की जानकारी हासिल करना.
- Maps Embed API में जगह के आईडी पैरामीटर का इस्तेमाल करना.
- Maps के यूआरएल में खोज क्वेरी वापस लाना.
- Roads API में, रफ़्तार की सीमाएं दिखाना.
- डेटा-ड्रिवन स्टाइलिंग में, सीमाओं के लिए बॉर्डर पॉलीगॉन ढूंढना और उन्हें स्टाइल करना.
किसी जगह का आईडी ढूंढना
क्या आपको किसी खास जगह का प्लेस आईडी चाहिए? किसी जगह को खोजने और उसका आईडी पाने के लिए, यहां दिए गए प्लेस आईडी फ़ाइंडर का इस्तेमाल करें:
इसके अलावा, Maps JavaScript API के दस्तावेज़ में, जगह का आईडी ढूंढने वाले टूल को उसके कोड के साथ देखा जा सकता है.
खास जानकारी
जगह का आईडी, टेक्स्ट वाला एक आइडेंटिफ़ायर होता है. इससे किसी जगह की खास तौर पर पहचान की जाती है. आइडेंटिफ़ायर की लंबाई अलग-अलग हो सकती है. जगह के आईडी की लंबाई तय नहीं होती. उदाहरण:
-
ChIJgUbEo8cfqokR5lP9_Wh_DaM -
GhIJQWDl0CIeQUARxks3icF8U8A -
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN -
EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E -
IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ
प्लेस आईडी, ज़्यादातर जगहों के लिए उपलब्ध हैं. इनमें कारोबार, लैंडमार्क, पार्क, और चौराहे शामिल हैं. एक ही जगह या लोकेशन के लिए, एक से ज़्यादा प्लेस आईडी हो सकते हैं. जगह के आईडी समय के साथ बदल सकते हैं.
Places API और कई Google Maps Platform एपीआई में, एक ही जगह के आईडी का इस्तेमाल किया जा सकता है. उदाहरण के लिए, एक ही जगह के आईडी का इस्तेमाल करके, Places API, Maps JavaScript API, Geocoding API, Maps Embed API, और Roads API में किसी जगह का रेफ़रंस दिया जा सकता है.
जगह के आईडी का इस्तेमाल करके, जगह की जानकारी पाना
जगह के आईडी का इस्तेमाल करने का एक सामान्य तरीका यह है कि किसी जगह को खोजा जाए. उदाहरण के लिए, Maps JavaScript API में Places API या Places लाइब्रेरी का इस्तेमाल करके. इसके बाद, जगह की जानकारी पाने के लिए, दिखाए गए जगह के आईडी का इस्तेमाल करें. जगह का आईडी सेव किया जा सकता है और उस जगह की जानकारी को बाद में वापस पाने के लिए उसका इस्तेमाल किया जा सकता है. जगह के आईडी सेव करने के बारे में यहां पढ़ें.
यहां दिए गए उदाहरणों में, Places API (नया) और Places API (लेगसी) के लिए आइकॉन के यूआरएल का अनुरोध करने का तरीका बताया गया है.
Places API (नया प्रॉडक्ट)
Places API का इस्तेमाल करके, टेक्स्ट से खोजने (नई सुविधा) का अनुरोध करके, जगह का आईडी पाया जा सकता है.
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'जवाब में id फ़ील्ड में जगह का आईडी शामिल होता है, जैसा कि यहां दिखाया गया है:
{
"places": [
{
"id": "ChIJs5ydyTiuEmsR0fRSlU0C7k0",
"formattedAddress": "29 King St, Sydney NSW 2000, Australia",
"displayName": {
"text": "Peace Harmony",
"languageCode": "en"
}
},
...
}अब अनुरोध के यूआरएल में जगह का आईडी शामिल करके, जगह की जानकारी (नया) का अनुरोध किया जा सकता है:
https://places.googleapis.com/v1/places/ChIJs5ydyTiuEmsR0fRSlU0C7k0?fields=id,displayName&key=API_KEY
Places API (लेगसी)
Places API का इस्तेमाल करके, जगह की खोज का अनुरोध करके, जगह का आईडी पाया जा सकता है.
यहां दिए गए उदाहरण में, ऑस्ट्रेलिया के सिडनी में किसी जगह से 1,500 मीटर के दायरे में, 'रेस्टोरेंट' टाइप की ऐसी जगहों के लिए खोज का अनुरोध किया गया है जिनके नाम में 'क्रूज़' शब्द शामिल है:
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(b) में बताई गई, कैश मेमोरी में डेटा सेव करने से जुड़ी पाबंदियों से प्लेस आईडी मुक्त हैं. इसलिए, प्लेस आईडी की वैल्यू को बाद में इस्तेमाल करने के लिए सेव किया जा सकता है.
सेव की गई जगहों के आईडी रीफ़्रेश करना
Google Maps के डेटाबेस में होने वाले अपडेट की वजह से, जगह के आईडी बदल सकते हैं. इसलिए, Google का सुझाव है कि अगर जगह के आईडी 12 महीने से ज़्यादा पुराने हैं, तो उन्हें रीफ़्रेश करें. fields पैरामीटर में सिर्फ़ प्लेस आईडी फ़ील्ड की जानकारी देकर, जगह की जानकारी का अनुरोध करके, प्लेस आईडी को बिना किसी शुल्क के रीफ़्रेश किया जा सकता है.
Places API (नया प्रॉडक्ट)
उदाहरण के लिए, जगह की जानकारी (नया) का इस्तेमाल करके:
https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY
Places API (लेगसी)
उदाहरण के लिए, Places API (लेगसी) का इस्तेमाल करके:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY
यह कॉल, जगह की जानकारी के लिए सिर्फ़ नए ज़रूरी आईडी या जगह की जानकारी - आईडी रीफ़्रेश SKU को ट्रिगर करता है.
प्लेस आईडी का इस्तेमाल करते समय गड़बड़ी के कोड
INVALID_REQUEST
INVALID_REQUEST स्टेटस कोड से पता चलता है कि दिया गया
प्लेस आईडी अमान्य है. INVALID_REQUEST तब दिख सकता है, जब जगह का आईडी काट दिया गया हो या उसमें बदलाव किया गया हो और वह अब सही न हो.
NOT_FOUND
NOT_FOUND स्टेटस कोड से पता चलता है कि दिया गया प्लेस आईडी अब काम नहीं करता. अगर कोई कारोबार बंद हो जाता है या किसी नई जगह पर शिफ़्ट हो जाता है, तो जगह का आईडी अमान्य हो सकता है. Google Maps के डेटाबेस में होने वाले अपडेट की वजह से भी, जगह के आईडी बदल सकते हैं. ऐसे मामलों में, किसी जगह को नया प्लेस आईडी मिल सकता है और पुराना आईडी NOT_FOUND रिस्पॉन्स दिखाता है.
अगर किसी जगह का आईडी अमान्य हो गया है, तो नतीजों को रीफ़्रेश करने के लिए, उस मूल अनुरोध को सेव करें जिससे हर जगह का आईडी मिला था. साथ ही, ज़रूरत के हिसाब से अनुरोध फिर से जारी करें. ध्यान दें कि फिर से जारी किए गए अनुरोध के लिए, सही SKU के हिसाब से बिलिंग की जाती है.
कुछ जगहों के आईडी की वजह से, कभी-कभी 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