स्थान आईडी

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

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

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

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

प्लेस आईडी इस्तेमाल करने का एक सामान्य तरीका किसी जगह की खोज करना है (Place 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"
      }
    },
  ...
}

अब आप जगह की जानकारी (नई) अनुरोध URL में स्थान ID शामिल करके अनुरोध करें:

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

बाद में इस्तेमाल के लिए जगह के आईडी सेव करें

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