API Địa điểm trả về thông tin về một địa điểm trong phản hồi. Cùng với nội dung thực tế, chẳng hạn như địa chỉ và số điện thoại, nội dung phản hồi cũng có thể chứa nội dung do người dùng đóng góp trên Google Maps, chẳng hạn như bài đánh giá và ảnh. Ngoài ra, khi bạn sử dụng các chức năng của mô hình Gemini cho API Địa điểm, phản hồi có thể bao gồm dữ liệu tạo sinh được tổng hợp và tóm tắt từ LLM.
Mặc dù Google đã triển khai một loạt biện pháp để xác định nội dung có vấn đề trước khi nội dung đó được API Địa điểm trả về, nhưng chúng tôi cũng cung cấp cách để người dùng gắn cờ nội dung không phù hợp để Google có thể xoá nội dung đó. Với bản phát hành này, API Địa điểm sẽ bao gồm trường flagContentUri mới trong tất cả bài đánh giá, ảnh và bản tóm tắt tạo sinh có trong phản hồi API Địa điểm. Trường này chứa một đường liên kết, bao gồm cả mã nhận dạng nội dung duy nhất, cho phép người dùng thông báo cho Google về nội dung không phù hợp.
Ví dụ: bạn gửi một yêu cầu trả về 5 bài đánh giá riêng lẻ cho một địa điểm. Mỗi bài đánh giá riêng lẻ đều có trường flagContentUri mới với giá trị nhận dạng duy nhất cho bài đánh giá đó để người dùng có thể báo cáo vấn đề với bất kỳ hoặc tất cả bài đánh giá.
Trình khám phá API cho phép bạn gửi yêu cầu trực tiếp để làm quen với các tuỳ chọn mới này:
Định dạng đường liên kết
URL có trong trường flagContentUri bao gồm một giá trị nhận dạng duy nhất cho nội dung. Khi bạn truy cập vào đường liên kết này, một trang web do Google lưu trữ sẽ mở ra dưới dạng:
Trong hộp thoại này, người dùng có thể gửi báo cáo cho Google về loại vấn đề thích hợp. Ví dụ: họ có thể báo cáo nội dung thô tục, bắt nạt hoặc có vấn đề pháp lý.
Giá
Tính năng này đang ở giai đoạn xem trước trước khi phát hành công khai và không tính phí, nghĩa là bạn sẽ không phải trả phí khi sử dụng trong giai đoạn Xem trước. Để biết thông tin chi tiết về mức giá đề xuất, hãy xem phần Hoạt động sử dụng và thanh toán API Địa điểm.
Hiển thị đường liên kết báo cáo nội dung
Bản phát hành Bản xem trước này thêm trường flagContentUri mới vào các đối tượng sau đây đã có trong phản hồi của API Địa điểm:
ReviewPhotoGenerativeSummaryChỉ dành choGenerativeSummary, có hai trường mới:overviewFlagContentUri: Đường liên kết để thông báo cho Google về nội dung không phù hợp trong phần thông tin tổng quan.descriptionFlagContentUri: Đường liên kết để thông báo cho Google về nội dung không phù hợp trong nội dung mô tả.
Trong giai đoạn Xem trước, bạn không bắt buộc phải hiển thị đường liên kết báo cáo nội dung khi hiển thị các đối tượng này cho khách hàng.
Tuy nhiên, khi tính năng này chuyển sang giai đoạn Phát hành công khai (GA), bạn phải hiển thị liên kết báo cáo nội dung khi hiển thị các đối tượng này để khách hàng có thể báo cáo mọi vấn đề về nội dung.
Truy cập vào đường liên kết báo cáo nội dung trong thư phản hồi
Yêu cầu Chi tiết về địa điểm sau đây bao gồm các bài đánh giá về địa điểm trong nội dung phản hồi:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Phản hồi có dạng:
{
"id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
"displayName": {
"text": "Googleplex",
"languageCode": "en"
},
"reviews": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB",
"relativePublishTimeDescription": "7 months ago",
"rating": 3,
"text": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"originalText": {
"text": "Came here for a tour and honestly,...",
"languageCode": "en"
},
"authorAttribution": {
"displayName": "John Smith",
"uri": "https://www.google.com/maps/contrib/10198693/reviews",
"photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6"
},
"publishTime": "2024-02-24T19:26:18.091264Z",
"flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
…
]
}Mỗi mục trong mảng reviews chứa trường flagContentUri, bao gồm cả giá trị nhận dạng duy nhất cho bài đánh giá cụ thể đó. Khi truy cập vào đường liên kết đó, khách hàng có thể báo cáo nội dung không phù hợp đối với bài đánh giá cụ thể đó.
Nếu bạn đưa photos vào mặt nạ trường:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews,photos" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Nội dung phản hồi cũng bao gồm mảng photos, trong đó mỗi phần tử chứa trường flagContentUri:
...
"photos": [
{
"name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo",
"widthPx": 4032,
"heightPx": 3024,
"authorAttributions": [
{
"displayName": "Jane Smith",
"uri": "https://maps.google.com/maps/contrib/107007354",
"photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo"
}
],
"flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr",
"googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5"
},
...
]Ngày hết hạn của đường liên kết
Các đường liên kết đến nội dung sẽ vẫn hoạt động cho đến khi nội dung sao lưu bị xoá. Các đường liên kết này sẽ tiếp tục mở hộp thoại cho nội dung đã bị xoá, nhưng việc gửi báo cáo về nội dung đã bị xoá sẽ không có tác dụng.
Hãy dùng thử!
Trình khám phá API cho phép bạn tạo các yêu cầu mẫu để làm quen với API và các tuỳ chọn API.
Chọn biểu tượng API,
, ở bên phải trang.Bạn có thể mở rộng phần Hiện các tham số chuẩn và đặt tham số
fieldsthành mặt nạ trường.Chỉnh sửa Phần nội dung yêu cầu (không bắt buộc).
Chọn nút Thực thi. Trong hộp thoại, hãy chọn tài khoản mà bạn muốn sử dụng để gửi yêu cầu.
Trong bảng điều khiển API Explorer (Trình khám phá API), hãy chọn biểu tượng mở rộng
để mở rộng cửa sổ API Explorer.