स्थान आईडी

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

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

  • जियोकोडिंग एपीआई वेब सर्विस और जियोकोडिंग सेवा, Maps JavaScript एपीआई में प्लेस आईडी के लिए पता वापस लाया जा रहा है.
  • निर्देश एपीआई के वेब सेवा और निर्देश सेवा, Maps JavaScript एपीआई में शुरुआत की जगह, मंज़िल, और बीच के रास्ते की जानकारी देना
  • दूरी के मैट्रिक्स की एपीआई के ज़रिए वेब सेवा और डिस्टेंस मैट्रिक्स की सेवा, Maps JavaScript एपीआई में ऑरिजिन और डेस्टिनेशन की जानकारी देना.
  • Places API वेब सेवा, Android के लिए Places SDK, iOS के लिए Places SDK, और स् थान लाइब्रेरी, JavaScript API में स्थान विवरण पुनर्प्राप्त करना.
  • Maps एंबेड एपीआई में जगह के आईडी पैरामीटर का इस्तेमाल करना.
  • Maps यूआरएल में खोज क्वेरी शामिल की जा रही हैं.
  • रोड एपीआई में रफ़्तार की सीमा दिखाना.
  • डेटा-ड्रिवन स्टाइल में सीमा पॉलीगॉन ढूंढना और उन्हें स्टाइल देना.

किसी खास जगह का आईडी ढूंढें

क्या आप किसी खास जगह का आईडी खोज रहे हैं? किसी जगह को खोजने और उसका आईडी पाने के लिए, जगह का आईडी ढूंढने वाली सुविधा का इस्तेमाल करें:

वैकल्पिक रूप से, आप Maps JavaScript एपीआई के दस्तावेज़ में प्लेस आईडी ढूंढने वाला टूल देख सकते हैं.

खास जानकारी

जगह का आईडी, टेक्स्ट के तौर पर एक आइडेंटिफ़ायर होता है. यह किसी जगह की पहचान करता है. पहचानकर्ता की लंबाई अलग-अलग हो सकती है. जगह के आईडी के लिए कोई ज़्यादा से ज़्यादा लंबाई नहीं होती है. उदाहरण:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

कारोबार की जगहों, लैंडमार्क, पार्क, और चौराहों समेत ज़्यादातर जगहों के लिए जगह के आईडी की सुविधा उपलब्ध है. एक ही जगह या जगह में कई अलग-अलग जगह के आईडी हो सकते हैं. जगह के आईडी समय के साथ बदल सकते हैं.

एक ही जगह के आईडी का इस्तेमाल, Places API और कई Google Maps Platform API में किया जा सकता है. उदाहरण के लिए, जगह एपीआई में मौजूद जगह, Maps JavaScript एपीआई, जियोकोडिंग एपीआई, मैप एम्बेड एपीआई, और रोड एपीआई के लिए, एक ही जगह के आईडी का इस्तेमाल किया जा सकता है.

जगह का आईडी इस्तेमाल करके जगह की जानकारी पाना

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

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

iOS के लिए Places SDK टूल का इस्तेमाल करने का उदाहरण

जगह का आईडी, टेक्स्ट के तौर पर एक आइडेंटिफ़ायर होता है. यह किसी जगह की पहचान करता है. iOS के लिए Places SDK टूल में, आप GMSPlace ऑब्जेक्ट से किसी जगह का आईडी पा सकते हैं. जगह के आईडी को स्टोर करें और उसका इस्तेमाल GMSPlace ऑब्जेक्ट को वापस पाने के लिए करें.

आईडी की मदद से जगह की जानकारी पाने के लिए, GMSPlacesClient fetchPlaceFromPlaceID: को कॉल करें. इसके लिए, ये पैरामीटर पास करें:

  • जगह के आईडी वाली स्ट्रिंग.
  • एक या एक से ज़्यादा GMSPlaceField, दिए जाने वाले डेटा के प्रकार तय करने के लिए.
  • अगर ऑटोकंप्लीट क्वेरी को खत्म करने के लिए कॉल किया जाता है, तो सेशन टोकन. अगर नहीं, तो कोई बात नहीं.
  • नतीजे को मैनेज करने के लिए, GMSPlaceResultCallback.

एपीआई, GMSPlace ऑब्जेक्ट में पास किए गए कॉलबैक के खास तरीके को शुरू करता है. अगर स्थान नहीं मिलता है, तो स्थान ऑब्जेक्ट शून्य है.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
  UInt(GMSPlaceField.placeID.rawValue))!

placesClient?.fetchPlace(fromPlaceID: placeID, placeFields: fields, sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    self.lblName?.text = place.name
    print("The selected place is: \(place.name)")
  }
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);

[_placesClient fetchPlaceFromPlaceID:placeID placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    NSLog(@"The selected place is: %@", [place name]);
  }
}];

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

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

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

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