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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

PlacesService (लेगसी) Place (नई)
getDetails() fetchFields()
PlaceDetailsRequest FetchFieldsRequest
तरीकों के लिए, नतीजों के ऑब्जेक्ट और google.maps.places.PlacesServiceStatus के जवाब को मैनेज करने के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है. यह Promises का इस्तेमाल करता है और एसिंक्रोनस तरीके से काम करता है.
तरीकों के लिए, PlacesServiceStatus की जांच करना ज़रूरी है. स्टेटस की जांच करना ज़रूरी नहीं है. इसमें, गड़बड़ी को मैनेज करने के स्टैंडर्ड तरीके का इस्तेमाल किया जा सकता है. ज़्यादा जानें.
जगह की जानकारी के डेटा फ़ील्ड को snake case का इस्तेमाल करके फ़ॉर्मैट किया जाता है. जगह की जानकारी के डेटा फ़ील्ड को camel case का इस्तेमाल करके फ़ॉर्मैट किया जाता है.
यह जगह के टाइप और जगह की जानकारी के डेटा फ़ील्ड के तय सेट तक सीमित है. यह जगह के टाइप और जगह की जानकारी के डेटा फ़ील्ड के लिए, अपडेट की गई ज़्यादा सुविधाएं उपलब्ध कराता है.

कोड की तुलना

इस सेक्शन में, Places Service और 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 क्लास (नई)

यहां दिया गया छोटा कोड स्निपेट, 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,
  });
}

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