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

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

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

कोड की तुलना

इस सेक्शन में, 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,
      });
    }
  });
}

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

• पूरे कोड का उदाहरण देखें
• जगह की जानकारी से जुड़ा दस्तावेज़
• 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,
  });
}

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

• पूरे कोड का उदाहरण देखें
• जगह की जानकारी से जुड़ा दस्तावेज़
• fetchFields() रेफ़रंस