مهاجرت به عکس‌های مکان جدید، مهاجرت به عکس‌های مکان جدید

عکس مکان به شما امکان می دهد محتوای عکاسی با کیفیت بالا را به صفحات وب خود اضافه کنید. این صفحه تفاوت‌های بین ویژگی‌های عکس مکان در کلاس Place (جدید) و PlacesService (میراث) را توضیح می‌دهد و چند قطعه کد برای مقایسه ارائه می‌کند.

• اگر فیلد photos در درخواست مشخص شده باشد، PlacesService (میراث) آرایه ای از حداکثر 10 شی PlacePhoto را به عنوان بخشی از شی PlaceResult برای هر درخواست getDetails() برمی گرداند. در مورد textSearch() و nearbySearch() عکس مکان اول به صورت پیش فرض در صورت موجود بودن برگردانده می شود.
• اگر فیلد photos در درخواست مشخص شده باشد، کلاس Place آرایه ای از حداکثر 10 شی Photo به عنوان بخشی از درخواست fetchFields() برمی گرداند.

جدول زیر برخی از تفاوت‌های اصلی در استفاده از عکس‌های مکان را بین کلاس Place و PlacesService فهرست می‌کند:

مقایسه کدها

این بخش کد عکس‌های مکان را مقایسه می‌کند تا تفاوت‌های بین سرویس Places و کلاس Place را نشان دهد. تکه‌های کد کد مورد نیاز برای درخواست عکس‌ها در هر API مربوطه را نشان می‌دهند.

خدمات مکان‌ها (قدیمی)

قطعه زیر بازگشت عکس ها با استفاده از PlacesService و نمایش اولین نتیجه عکس در صفحه را نشان می دهد. در این مثال، درخواست جزئیات مکان، شناسه مکان را به همراه فیلدهای name و photos مشخص می کند. پس از بررسی وضعیت سرویس، اولین عکس در صفحه نمایش داده می شود. هنگام نمونه سازی PlacesService ، یک نقشه یا یک عنصر div باید مشخص شود. از آنجایی که این مثال دارای نقشه نیست، از عنصر div استفاده شده است.

function getPhotos() {
  // Construct the Place Details request.
  const request = {
    placeId: "ChIJydSuSkkUkFQRsqhB-cEtYnw",
    fields: ["name", "photos"],
  };

  // Create an instance of PlacesService.
  const attributionDiv = document.getElementById("attribution-div");
  const service = new google.maps.places.PlacesService(attributionDiv);

  // Check status and display the first photo in an img element.
  service.getDetails(request, (place, status) => {
    if (
      status === google.maps.places.PlacesServiceStatus.OK && place
    ) {
      const photoImg = document.getElementById('image-container');
      photoImg.src = place.photos[0].getUrl({maxHeight: 400});
    }
  });
}

اسناد نویسنده در PlacesService

PlacesService ارجاعات نویسنده مورد نیاز را به عنوان یک رشته html_attributions حاوی یک URL که به صفحه نمایه Google نویسنده اشاره دارد، برمی گرداند. قطعه زیر بازیابی داده های انتساب را برای اولین نتیجه عکس نشان می دهد.

let attributionUrl = place.photos[0].html_attributions;

بیشتر بدانید

• مستندات را ببینید
• مرجع getDetails
• مرجع رابط PlacePhoto

مکان کلاس (جدید)

قطعه زیر با استفاده از متد fetchFields() برای بازگرداندن جزئیات مکان از جمله نام نمایشی و عکس‌های مکان را نشان می‌دهد. ابتدا یک شیء Place جدید با استفاده از شناسه مکان و سپس فراخوانی به fetchFields() که در آن فیلدهای displayName و photos مشخص شده اند، نمونه سازی می شود. سپس اولین عکس در صفحه نمایش داده می شود. هنگام استفاده از کلاس Place ، نیازی به بررسی وضعیت سرویس نیست، زیرا این مورد به صورت خودکار مدیریت می شود.

async function getPhotos() {
  // Use a place ID to create a new Place instance.
  const place = new google.maps.places.Place({
      id: 'ChIJydSuSkkUkFQRsqhB-cEtYnw', // Woodland Park Zoo, Seattle WA
  });

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

  console.log(place.displayName);
  console.log(place.photos[0]);
  // Add the first photo to an img element.
  const photoImg = document.getElementById('image-container');
  photoImg.src = place.photos[0].getURI({maxHeight: 400});
}

اسناد نویسنده در کلاس Place

کلاس Place اسناد نویسنده را به عنوان یک نمونه AuthorAttribution شامل نام نویسنده، یک URI برای صفحه نمایه Google نویسنده و یک URI برای عکس نمایه نویسنده برمی‌گرداند. قطعه زیر بازیابی داده های انتساب را برای اولین نتیجه عکس نشان می دهد.

let name = place.photos[0].authorAttributions[0].displayName;
let attributionUrl = place.photos[0].authorAttributions[0].uri;
let photoUrl = place.photos[0].authorAttributions[0].photoUri;

بیشتر بدانید

• نمونه کامل را ببینید
• مستندات را ببینید
• مرجع fetchFields()
• مرجع کلاس Photo