स्थान आईडी

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

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

  • Geocoding API की वेब सेवा और जियोकोडिंग सेवा, Maps JavaScript API में किसी प्लेस आईडी के लिए पता पाना.
  • रूट एपीआई और डाइरेक्शन एपीआई की वेब सेवा और निर्देश सेवा, Maps JavaScript API में ऑरिजिन, डेस्टिनेशन, और इंटरमीडिएट वेपॉइंट तय करना.
  • रूट एपीआई और डिस्टेंस मैट्रिक्स एपीआई की वेब सेवा और डिस्टेंस मैट्रिक्स सेवा, Maps JavaScript एपीआई में ऑरिजिन और डेस्टिनेशन की जानकारी देना.
  • 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 एपीआई में एक ही जगह के आईडी का इस्तेमाल कर सकते हैं. उदाहरण के लिए, जगह एपीआई, Maps JavaScript API, जियोकोडिंग एपीआई, Maps Embed API, और Roads API में किसी जगह का रेफ़रंस देने के लिए, एक ही जगह के आईडी का इस्तेमाल किया जा सकता है.

स्थान आईडी का उपयोग करके स्थान विवरण फिर से पाएं

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

नीचे दिए गए उदाहरण, 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 का इस्तेमाल करके, जगह की खोज का अनुरोध करके जगह का आईडी ढूंढा जा सकता है.

नीचे दिए गए उदाहरण में, ऑस्ट्रेलिया के सिडनी के एक पॉइंट के 1500 मीटर के दायरे में मौजूद 'रेस्टोरेंट' टाइप की जगहों के लिए खोज अनुरोध है. इसमें 'क्रूज़' शब्द शामिल है:

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) में कैश मेमोरी में सेव करने की पाबंदियों से छूट मिली है. इसलिए, जगह के आईडी की वैल्यू को बाद में इस्तेमाल करने के लिए सेव किया जा सकता है.

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

अगर जगह के आईडी 12 महीने से ज़्यादा पुराने हैं, तो हमारा सुझाव है कि आप उन्हें रीफ़्रेश करें. जगह की जानकारी का अनुरोध करके, जगह के आईडी को बिना किसी शुल्क के रीफ़्रेश किया जा सकता है. साथ ही, fields पैरामीटर में सिर्फ़ जगह का आईडी फ़ील्ड शामिल किया जा सकता है.

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

उदाहरण के लिए, जगह की जानकारी (नया) का इस्तेमाल करके:

https://places.googleapis.com/v1/places/ChIJ05IRjKHxEQ0RJLV_5NLdK2w?fields=id&key=API_KEY

Places API

उदाहरण के लिए, जगह की जानकारी के लेगसी एपीआई का इस्तेमाल करना: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ05IRjKHxEQ0RJLV_5NLdK2w&fields=place_id&key=API_KEY

इस कॉल से जगह की जानकारी नई है (सिर्फ़ आईडी) या जगहों की जानकारी - आईडी रीफ़्रेश करें 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