जगह के आईडी

परिचय

जगह के आईडी, 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 लाइब्रेरी का इस्तेमाल करके. इसके बाद, जगह की जानकारी पाने के लिए, दिखाए गए जगह के आईडी का इस्तेमाल करें. जगह का आईडी सेव किया जा सकता है और उस जगह की जानकारी को बाद में वापस पाने के लिए इसका इस्तेमाल किया जा सकता है. जगह के आईडी सेव करने के बारे में यहां पढ़ें.

Maps JavaScript API में Places Library का इस्तेमाल करने का उदाहरण

अपने JavaScript ऐप्लिकेशन में जगह का आईडी इस्तेमाल करने के लिए, आपको पहले आईडी ढूंढना होगा. यह आईडी, Place Search की मदद से मिलने वाले PlaceResult या जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) की मदद से मिलने वाले getPlace() में उपलब्ध होता है. इसके बाद, जगह के आईडी का इस्तेमाल करके, जगह की जानकारी देखी जा सकती है.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

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

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

सेव की गई जगहों के आईडी रीफ़्रेश करना

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

यह कॉल, जगह की जानकारी - आईडी रीफ़्रेश 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