जगह के आईडी

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

जगह के आईडी, 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 वेब सेवा, Android के लिए Places SDK टूल, iOS के लिए Places SDK टूल, और 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"
      }
    },
  ...
}

अब अनुरोध के यूआरएल में जगह का आईडी शामिल करके, Places API (नया) का अनुरोध किया जा सकता है:

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 का सुझाव है कि अगर जगह के आईडी 12 महीने से ज़्यादा पुराने हैं, तो उन्हें रीफ़्रेश करें. प्लेस आईडी को बिना किसी शुल्क के रीफ़्रेश किया जा सकता है. इसके लिए, fields पैरामीटर में सिर्फ़ प्लेस आईडी फ़ील्ड की जानकारी दें और जगह की जानकारी का अनुरोध करें.

Places API (नया प्रॉडक्ट)

उदाहरण के लिए, 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 को ट्रिगर करता है.

इस अनुरोध से, NOT_FOUND स्टेटस कोड भी मिल सकता है. एक रणनीति यह है कि हर जगह का आईडी दिखाने वाले ओरिजनल अनुरोध को सेव किया जाए. अगर कोई प्लेस आईडी अमान्य हो जाता है, तो नए नतीजे पाने के लिए, उस अनुरोध को फिर से जारी किया जा सकता है. इन नतीजों में, ओरिजनल जगह शामिल हो सकती है या नहीं भी. हालांकि, इस अनुरोध के लिए शुल्क लिया जाता है.

ध्यान दें: किसी जगह का आईडी अमान्य होने के बाद, शुरुआती कुछ दिनों तक इस रणनीति से 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