Places API (New) menampilkan informasi tentang suatu tempat dalam respons. Selain konten faktual, seperti alamat dan nomor telepon, respons juga dapat berisi konten yang telah dikontribusikan pengguna di Google Maps, seperti ulasan dan foto. Selain itu, saat Anda menggunakan kemampuan model Gemini untuk Places API (New), responsnya dapat menyertakan data generatif yang digabungkan dan diringkas dari LLM.
Meskipun Google telah menerapkan serangkaian tindakan untuk mengidentifikasi konten
bermasalah sebelum ditampilkan oleh Places API (New), kami juga menyediakan
cara bagi pengguna untuk melaporkan konten yang tidak pantas agar Google dapat menghapusnya. Dengan
rilis ini, Places API (New) menyertakan kolom flagContentUri baru
di semua ulasan, foto, dan ringkasan generatif yang disertakan dalam
respons Places API (New). Kolom ini berisi link, termasuk ID konten unik, yang memungkinkan pengguna memberi tahu Google tentang konten yang tidak pantas.
Misalnya, Anda membuat permintaan yang menampilkan lima ulasan individual untuk suatu tempat. Setiap ulasan mencakup kolom flagContentUri baru dengan ID unik untuk ulasan tersebut sehingga pengguna dapat melaporkan masalah pada salah satu atau semua ulasan.
APIs Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami opsi baru ini:
Format link
URL yang terdapat dalam kolom flagContentUri menyertakan ID unik untuk konten. Membuka link ini akan membuka halaman web yang dihosting oleh Google dalam formulir:
Dari dialog ini, pengguna Anda dapat mengajukan laporan kepada Google untuk jenis masalah yang sesuai. Misalnya, mereka dapat melaporkan kata-kata tidak sopan, penindasan, atau masalah hukum terkait konten.
Menampilkan link pelaporan konten
Kolom flagContentUri tersedia dalam objek berikut yang sudah menjadi bagian dari respons Places API (New):
ReviewPhotoGenerativeSummaryNeighborhoodSummaryEvChargeAmenitySummaryReviewSummaryContextualContent
Anda harus menampilkan link pelaporan konten saat menampilkan objek ini agar pelanggan dapat melaporkan masalah konten apa pun.
Mengakses link pelaporan konten dalam respons
Permintaan Place Details (Baru) berikut menyertakan ulasan tempat dalam respons:
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
Responsnya dalam bentuk:
{
"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"
},
…
]
}Setiap entri dalam array reviews berisi kolom flagContentUri, termasuk ID unik untuk ulasan spesifik tersebut. Dengan membuka link tersebut, pelanggan Anda dapat melaporkan konten tidak pantas untuk ulasan tertentu.
Jika Anda menyertakan photos dalam mask kolom:
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
Respons juga menyertakan array photos yang setiap elemennya berisi kolom 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"
},
...
]Masa berlaku link
Link konten tetap aktif hingga konten pendukung dihapus. Link akan terus membuka dialog untuk konten yang telah dihapus, tetapi mengajukan laporan tentang konten yang telah dihapus tidak akan berpengaruh.
Cobalah!
API Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.
Pilih ikon API,
, di sisi kanan halaman.Jika perlu, luaskan Show standard parameters dan tetapkan parameter
fieldske field mask.Jika perlu, edit Request body.
Pilih tombol Execute. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon luaskan,
, untuk meluaskan jendela API Explorer.