Перенести на новые фотографии места

Разработчики Европейской экономической зоны (ЕЭЗ)

Функция «Фотографии мест» позволяет добавлять высококачественный фотоконтент на веб-страницы. На этой странице объясняются различия между функциями «Фотографии мест» в классе Place (новый) и PlacesService (старый), а также приводятся некоторые фрагменты кода для сравнения.

  • PlacesService (устаревшая версия) возвращает массив, содержащий до 10 объектов PlacePhoto , в составе объекта PlaceResult для любого запроса getDetails() , если в запросе указано поле photos . В случае textSearch() и nearbySearch() по умолчанию возвращается фотография первого места, если она доступна.
  • Класс Place возвращает массив, содержащий до 10 объектов Photo как часть запроса fetchFields() , если в запросе указано поле photos .

В следующей таблице перечислены некоторые основные различия в использовании фотографий мест между классом Place и PlacesService :

PlacesService (устаревший) Place (новое)
Интерфейс PlacePhoto Photo
PlacePhoto возвращает html_attributions как строку. Photo возвращает экземпляр AuthorAttribution .
Методы требуют использования обратного вызова для обработки объекта результатов и ответа google.maps.places.PlacesServiceStatus . Использует Promises и работает асинхронно.
Методы требуют проверки PlacesServiceStatus . Проверка статуса не требуется, можно использовать стандартную обработку ошибок. Подробнее .
Экземпляр PlacesService должен быть создан с использованием карты или элемента div. Place может быть создано в любом месте, где это необходимо, без ссылки на карту или элемент страницы.

Сравнение кодов

В этом разделе сравнивается код для фотографий мест, чтобы проиллюстрировать различия между сервисом 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;

Узнать больше

Место класс (новый)

В следующем фрагменте кода показано использование метода 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;

Узнать больше