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

Place photos позволяет добавлять высококачественный фотографический контент на веб-страницы. На этой странице объясняются различия между функциями place photos в классе 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 Service и классом 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;

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