जगह के आईडी

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा
यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

  • Geocoding API और Geocoding Service, Maps JavaScript API में किसी जगह के आईडी के लिए पता पाना.
  • Routes API और Directions API (लेगसी) और Directions Service, Maps JavaScript API (लेगसी) में शुरुआत की जगह, मंज़िल, और बीच के वेपॉइंट की जानकारी देना.
  • Routes API, Distance Matrix API (लेगसी), और Maps JavaScript API (लेगसी) की Distance Matrix सेवा में, शुरुआत और मंज़िल की जगह की जानकारी देना.
  • Places API (नया), Android के लिए Places SDK (नया), iOS के लिए Places SDK (नया), और जगहों की लाइब्रेरी में जगह की जानकारी हासिल करना.
  • Maps Embed API में, जगह के आईडी के पैरामीटर इस्तेमाल करना.
  • Maps के यूआरएल में सर्च क्वेरी वापस पाना.
  • Roads API में स्पीड लिमिट दिखाना.
  • सीमाओं के लिए डेटा-ड्रिवन स्टाइलिंग की सुविधा में, सीमा के पॉलीगॉन ढूंढना और उन्हें स्टाइल करना.

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

क्या आपको किसी खास जगह का आईडी चाहिए? किसी जगह को खोजने और उसका आईडी पाने के लिए, नीचे दिए गए जगह का आईडी फ़ाइंडर का इस्तेमाल करें:

इसके अलावा, Maps JavaScript API के दस्तावेज़ में, कोड के साथ जगह का आईडी ढूंढने वाला टूल देखा जा सकता है.

कोड या एआई एजेंट की मदद से, जगह के आईडी ढूंढना

जगह का आईडी ढूंढने वाला टूल, ब्राउज़र में एक बार में एक ही जगह का आईडी ढूंढता है. किसी ऐप्लिकेशन, स्क्रिप्ट या एआई एजेंट से जगह के आईडी खोजने के लिए, एपीआई को कॉल करें:

  • अपने कोड से: टेक्स्ट से खोजें (नया) अनुरोध भेजें. इसमें फ़ील्ड की सूची को Place.Field.ID पर सेट करें. सिर्फ़ जगह के आईडी दिखाने वाले अनुरोधों के लिए, Places API Text Search Essentials (IDs Only) SKU के तहत बिलिंग की जाती है.
  • एआई एजेंट या एलएलएम ऐप्लिकेशन से: Maps Experience एजेंट टूल में Resolution API का इस्तेमाल करें. resolve_names और resolve_maps_urls एमसीपी टूल, हर अनुरोध में ज़्यादा से ज़्यादा 20 जगहों के नाम, पते या Google Maps के यूआरएल को जगह के आईडी में बदल सकते हैं. ये तरीके, resolveNames और resolveMapsUrls REST तरीकों की तरह ही उपलब्ध हैं.

खास जानकारी

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

  • 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 SDK for Android (नया) का इस्तेमाल करने का उदाहरण

Places SDK for Android (नया वर्शन) में, किसी जगह का आईडी पाने के लिए, Place.getId() को कॉल करें. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) सेवा, सर्च क्वेरी और फ़िल्टर से मैच होने वाली हर जगह के लिए, जगह का आईडी भी दिखाती है. जगह के आईडी का इस्तेमाल करके, Place ऑब्जेक्ट को बाद में फिर से वापस पाएं.

आईडी से किसी जगह की जानकारी पाने के लिए, PlacesClient.fetchPlace() को कॉल करें और FetchPlaceRequest पास करें.

एपीआई, Task में FetchPlaceResponse दिखाता है. FetchPlaceResponse में एक Place ऑब्जेक्ट होता है, जो दिए गए जगह के आईडी से मैच करता है.

यहां दिए गए कोड के उदाहरण में, किसी जगह की जानकारी पाने के लिए fetchPlace() को कॉल करने का तरीका बताया गया है.

Kotlin

// Define a Place ID.
val placeId = PlaceIdProvider.getRandomPlaceId()

// Specify the fields to return.
val placeFields = listOf(
    Place.Field.ID,
    Place.Field.DISPLAY_NAME,
    Place.Field.FORMATTED_ADDRESS,
    Place.Field.LOCATION,
)

// Construct a request object, passing the place ID and fields array.
val request = FetchPlaceRequest.newInstance(placeId, placeFields)

placesClient.fetchPlace(request)
    .addOnSuccessListener { response: FetchPlaceResponse ->
        val place = response.place

        val name = place.displayName
        val address = place.formattedAddress
        val location = place.location

        binding.placeName.text = name
        binding.placeAddress.text = address
        if (location != null) {
            binding.placeLocation.text = getString(
                R.string.place_location,
                location.latitude,
                location.longitude,
            )
        } else {
            binding.placeLocation.text = null
        }
        Log.i(TAG, "Place found: ${place.displayName}")
    }.addOnFailureListener { exception: Exception ->
        if (exception is ApiException) {
            val message = getString(R.string.place_not_found, exception.message)
            binding.placeName.text = message
            Log.e(TAG, "Place not found: ${exception.message}")
            val statusCode = exception.statusCode
            TODO("Handle error with given status code")
        }
    }

Java

// Define a Place ID.
final String placeId = PlaceIdProvider.getRandomPlaceId();

// Specify the fields to return.
final List<Place.Field> placeFields =
        Arrays.asList(
                Place.Field.ID,
                Place.Field.DISPLAY_NAME,
                Place.Field.FORMATTED_ADDRESS,
                Place.Field.LOCATION);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient
        .fetchPlace(request)
        .addOnSuccessListener(
                (response) -> {
                    Place place = response.getPlace();

                    final CharSequence name = place.getDisplayName();
                    final CharSequence address = place.getFormattedAddress();
                    final LatLng location = place.getLocation();

                    binding.placeName.setText(name);
                    binding.placeAddress.setText(address);
                    if (location != null) {
                        binding.placeLocation.setText(
                                getString(
                                        R.string.place_location,
                                        location.latitude,
                                        location.longitude));
                    } else {
                        binding.placeLocation.setText(null);
                    }

                    Log.i(TAG, "Place found: " + place.getDisplayName());
                })
        .addOnFailureListener(
                (exception) -> {
                    if (exception instanceof ApiException apiException) {
                        final String message =
                                getString(
                                        R.string.place_not_found,
                                        apiException.getMessage());
                        binding.placeName.setText(message);
                        Log.e(TAG, "Place not found: " + exception.getMessage());
                        final int statusCode = apiException.getStatusCode();
                        // TODO: Handle error with given status code.
                    }
                });

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

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

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

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

इस कॉल से, Places Details - ID Refresh एसकेयू ट्रिगर होता है.

जगह के आईडी इस्तेमाल करते समय गड़बड़ी के कोड

INVALID_REQUEST

INVALID_REQUEST स्टेटस कोड से पता चलता है कि दिया गया जगह का आईडी मान्य नहीं है. INVALID_REQUEST तब दिख सकता है, जब जगह के आईडी को छोटा किया गया हो या उसमें कोई बदलाव किया गया हो और वह अब सही न हो.

NOT_FOUND

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