Обзоры мест позволяют добавлять отзывы и оценки пользователей на ваши веб-страницы. На этой странице объясняются различия между отзывами мест, используемыми в классе Place
(новом) и PlacesService
(устаревшим), а также приводятся некоторые фрагменты кода для сравнения.
-
PlacesService
(устаревшая версия) возвращает массив экземпляровPlaceReview
как часть объектаPlaceResult
для любого запросаgetDetails()
, если в запросе указано полеreviews
. -
Place
(new) возвращает массив экземпляровReview
как часть запросаfetchFields()
если в запросе указано полеreviews
.
В следующей таблице перечислены некоторые основные различия в использовании обзоров мест между классами Place
и PlacesService
:
PlacesService (устаревшая версия) | Place (Новое) |
---|---|
Интерфейс PlaceReview | Review класса |
Методы требуют использования обратного вызова для обработки объекта результатов и ответа google.maps.places.PlacesServiceStatus . | Использует обещания и работает асинхронно. |
Методы требуют проверки PlacesServiceStatus . | Не требуется проверка статуса, можно использовать стандартную обработку ошибок. |
PlacesService должен быть создан с использованием карты или элемента div. | Place может быть создан где угодно, без ссылки на карту или элемент страницы. |
PlaceReview возвращает данные об авторстве обзора, используя author_name , author_url profile_photo_url . | Review возвращает данные об атрибуции обзора с использованием экземпляра AuthorAttribution . |
Сравнение кода
В этом разделе сравнивается код методов текстового поиска, чтобы проиллюстрировать различия между обзорами мест в устаревшем PlacesService
и новом классе Place
.
Служба адресов (устаревшая версия)
Следующий фрагмент вызывает getDetails()
для запроса сведений о месте, включая отзывы, и отображает первый результат обзора в информационном окне.
const request = {
placeId: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
fields: ["name", "formatted_address", "geometry", "reviews"],
};
const service = new google.maps.places.PlacesService(map);
service.getDetails(request, (place, status) => {
if (
status === google.maps.places.PlacesServiceStatus.OK &&
place &&
place.geometry &&
place.geometry.location
) {
// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
// Get info for the first review.
let reviewRating = place.reviews[0].rating;
let reviewText = place.reviews[0].text;
let authorName = place.reviews[0].author_name;
let authorUri = place.reviews[0].author_url;
// Format the review using HTML.
contentString =`
<div id="title"><b>${place.name}</b></div>
<div id="address">${place.formatted_address}</div>
<a href="${authorUri}" target="_blank">Author: ${authorName}</a>
<div id="rating">Rating: ${reviewRating} stars</div>
<div id="rating"><p>Review: ${reviewText}</p></div>`;
} else {
contentString = `No reviews were found for ${place.name}`;
}
const infowindow = new google.maps.InfoWindow({
content: contentString,
ariaLabel: place.displayName,
});
// Add a marker.
const marker = new google.maps.Marker({
map,
position: place.geometry.location,
});
// Show the info window.
infowindow.open({
anchor: marker,
map,
});
}
});
Класс места (новый)
Следующий фрагмент кода вызывает метод fetchFields()
для запроса сведений о месте, включая отзывы, и отображает первый результат обзора в информационном окне.
// Use a place ID to create a new Place instance.
const place = new google.maps.places.Place({
id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
});
// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
fields: ["displayName", "formattedAddress", "location", "reviews"],
});
// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
// Get info for the first review.
let reviewRating = place.reviews[0].rating;
let reviewText = place.reviews[0].text;
let authorName = place.reviews[0].authorAttribution.displayName;
let authorUri = place.reviews[0].authorAttribution.uri;
// Format the review using HTML.
contentString =`
<div id="title"><b>${place.displayName}</b></div>
<div id="address">${place.formattedAddress}</div>
<a href="${authorUri}" target="_blank">Author: ${authorName}</a>
<div id="rating">Rating: ${reviewRating} stars</div>
<div id="rating"><p>Review: ${reviewText}</p></div>`;
} else {
contentString = `No reviews were found for ${place.displayName}`;
}
// Create an infowindow to display the review.
infoWindow = new google.maps.InfoWindow({
content: contentString,
ariaLabel: place.displayName,
});
// Add a marker.
const marker = new google.maps.marker.AdvancedMarkerElement({
map,
position: place.location,
title: place.displayName,
});
// Show the info window.
infoWindow.open({
anchor: marker,
map,
});