Places API (Baru) 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 (Baru), respons dapat mencakup data generatif yang digabungkan dan diringkas dari LLM.
Meskipun Google telah menerapkan serangkaian tindakan untuk mengidentifikasi konten bermasalah sebelum ditampilkan oleh Places API (Baru), kami juga menyediakan cara bagi pengguna untuk melaporkan konten tidak pantas agar Google dapat menghapusnya. Dengan
rilis ini, Places API (Baru) menyertakan kolom flagContentUri
baru
di semua ulasan, foto, dan ringkasan generatif yang disertakan dalam
respons Places API (Baru). Kolom ini berisi link, termasuk ID konten unik, yang memungkinkan pengguna memberi tahu Google tentang konten tidak pantas.
Misalnya, Anda membuat permintaan yang menampilkan lima ulasan individual untuk suatu tempat. Setiap ulasan individu menyertakan kolom flagContentUri
baru dengan
ID unik untuk ulasan tersebut sehingga pengguna dapat melaporkan masalah pada salah satu atau
semua ulasan.
API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami opsi baru ini:
Format link
URL yang ada di kolom flagContentUri
menyertakan ID unik untuk
konten. Membuka link ini akan membuka halaman web yang dihosting Google dalam bentuk:
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 tersebut.
Menampilkan link pelaporan konten
Kolom flagContentUri
tersedia di objek berikut yang sudah menjadi bagian dari respons Places API (Baru):
Review
Photo
GenerativeSummary
NeighborhoodSummary
EvChargeAmenitySummary
ReviewSummary
ContextualContent
Anda harus menampilkan link pelaporan konten saat menampilkan objek ini agar pelanggan dapat melaporkan masalah konten.
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 tertentu tersebut. Dengan membuka link tersebut, pelanggan Anda dapat melaporkan konten yang tidak pantas untuk ulasan tertentu tersebut.
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 akan tetap aktif hingga konten pendukung dihapus. Link tersebut tetap membuka dialog untuk konten yang telah dihapus, tetapi pengajuan laporan pada 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 Tampilkan parameter standar dan tetapkan parameter
fields
ke masker kolom.Edit Isi permintaan jika perlu.
Pilih tombol Jalankan. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.
Di panel API Explorer, pilih ikon perluas,
, untuk meluaskan jendela API Explorer.