जगह की जानकारी की नई सुविधा पर माइग्रेट करना

Places API, किसी खास जगह के बारे में ज़्यादा जानकारी दे सकता है. इस पेज पर, Place क्लास (नया) और PlacesService (लेगसी) में इस्तेमाल की गई जगह की जानकारी के बीच के अंतर के बारे में बताया गया है. साथ ही, तुलना करने के लिए कुछ कोड स्निपेट दिए गए हैं. यहां दी गई टेबल में, Place क्लास और PlacesService के बीच, Place Details के इस्तेमाल में कुछ मुख्य अंतर बताए गए हैं:

कोड की तुलना करना

इस सेक्शन में, मिलते-जुलते दो कोड की तुलना की गई है. इससे Places API और Place क्लास के बीच के अंतर को समझने में मदद मिलती है. कोड स्निपेट में, हर एपीआई के लिए ज़रूरी कोड दिखाया गया है. इससे जगह की जानकारी का अनुरोध किया जा सकता है. इसके बाद, जगह के डेटा का इस्तेमाल करके, मैप पर मार्कर जोड़ा जा सकता है.

Places Service (लेगसी)

नीचे दिए गए कंडेंस्ड कोड स्निपेट में, PlacesService का इस्तेमाल करके जगह की जानकारी के लिए अनुरोध करने का तरीका दिखाया गया है. अनुरोध में कॉलबैक का इस्तेमाल किया गया हो. साथ ही, इसमें PlacesServiceStatus पर ज़रूरी शर्त की जांच शामिल हो. जगह की जानकारी वाले ज़रूरी डेटा फ़ील्ड, अनुरोध के मुख्य हिस्से में दिए गए हैं.

function getPlaceDetails() {
  // Instantiate the Places Service.
  const service = new google.maps.places.PlacesService(map);

  // Make a request using the Place ID.
  const request = {
    placeId: "ChIJN1t_tDeuEmsRUsoyG83frY4",
    fields: ["name", "formatted_address", "place_id", "geometry"],
  };

  // Request place details.
  service.getDetails(request, (place, status) => {
    // Check whether PlacesServiceStatus is OK.
    if (
      status === google.maps.places.PlacesServiceStatus.OK &&
      place &&
      place.geometry &&
      place.geometry.location
    ) {

      // Log the result.
      console.log(place.name);
      console.log(place.formatted_address);

      // Add a marker for the place.
      const marker = new google.maps.Marker({
        map,
        position: place.geometry.location,
        title: place.name,
      });
    }
  });
}

ज़्यादा जानें

• कोड का पूरा उदाहरण देखें
• Place Details से जुड़ा दस्तावेज़
• getDetails रेफ़रंस

जगह की क्लास (नई)

यहां दिए गए छोटे कोड स्निपेट में, Place क्लास का इस्तेमाल करके, जगह की जानकारी का अनुरोध करने का तरीका बताया गया है. अनुरोध एसिंक्रोनस है और इसमें स्टेटस की जांच शामिल नहीं है. हालांकि, स्टैंडर्ड गड़बड़ी को ठीक करने की सुविधा का इस्तेमाल किया जा सकता है. किसी जगह के आईडी का इस्तेमाल, नया Place इंस्टेंस बनाने के लिए किया जाता है. इसका इस्तेमाल अनुरोध (fetchFields()) करने के लिए किया जाता है. fetchFields() को कॉल किए जाने तक, जगह के ज़रूरी डेटा फ़ील्ड पास नहीं किए जाते. इससे ज़्यादा फ़्लेक्सिबिलिटी मिलती है. fetchFields() तरीके में await ऑपरेटर का इस्तेमाल किया जाता है. इसलिए, इसका इस्तेमाल सिर्फ़ async फ़ंक्शन में किया जा सकता है.

async function getPlaceDetails() {
  // Use place ID to create a new Place instance.
  const place = new google.maps.places.Place({
    id: "ChIJN5Nz71W3j4ARhx5bwpTQEGg",
    requestedLanguage: "en", // optional
  });

  // Call fetchFields, passing the needed data fields.
  await place.fetchFields({
    fields: ["displayName", "formattedAddress", "location"],
  });

  // Log the result.
  console.log(place.displayName);
  console.log(place.formattedAddress);

  // Add an Advanced Marker.
  const marker = new google.maps.marker.AdvancedMarkerElement({
    map,
    position: place.location,
    title: place.displayName,
  });
}

ज़्यादा जानें

• पूरा कोड उदाहरण देखें
• Place Details से जुड़ा दस्तावेज़
• fetchFields() reference