Places API (ใหม่) จะแสดงข้อมูลเกี่ยวกับสถานที่ในการตอบกลับ นอกจากเนื้อหาที่เป็นข้อเท็จจริง เช่น ที่อยู่และหมายเลขโทรศัพท์แล้ว การตอบกลับยังอาจมีเนื้อหาที่ผู้ใช้ให้ไว้ใน Google Maps เช่น รีวิวและรูปภาพด้วย นอกจากนี้ เมื่อคุณใช้ความสามารถของโมเดล Gemini สำหรับ Places API (ใหม่) การตอบกลับอาจรวมข้อมูล Generative ที่รวบรวมและสรุปจาก LLM ด้วย
แม้ว่า Google จะใช้มาตรการต่างๆ เพื่อระบุเนื้อหาที่เป็นปัญหาก่อนที่ Places API (ใหม่) จะแสดงผล แต่เราก็มีวิธีให้ผู้ใช้แจ้งว่าเนื้อหาไม่เหมาะสมเพื่อให้ Google นำเนื้อหาดังกล่าวออกได้ ในรุ่นนี้ Places API (ใหม่) จะมีฟิลด์ flagContentUri ใหม่ในรีวิว รูปภาพ และข้อมูลสรุปจาก Generative AI ทั้งหมดที่รวมอยู่ในการตอบกลับของ Places API (ใหม่) ช่องนี้มีลิงก์ซึ่งรวมถึงตัวระบุเนื้อหาที่ไม่ซ้ำกัน ซึ่งช่วยให้ผู้ใช้แจ้ง Google เกี่ยวกับเนื้อหาที่ไม่เหมาะสมได้
เช่น คุณส่งคำขอที่แสดงผลรีวิว 5 รายการสำหรับสถานที่หนึ่งๆ รีวิวแต่ละรายการจะมีช่อง flagContentUri ใหม่พร้อมตัวระบุที่ไม่ซ้ำกันสำหรับรีวิวนั้น เพื่อให้ผู้ใช้รายงานปัญหาเกี่ยวกับรีวิวบางรายการหรือทั้งหมดได้
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบสดเพื่อให้คุ้นเคยกับตัวเลือกใหม่ๆ ต่อไปนี้ได้
รูปแบบลิงก์
URL ที่อยู่ในช่อง flagContentUri มีตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหา การไปยังลิงก์นี้จะเปิดหน้าเว็บที่โฮสต์โดย Google ในรูปแบบต่อไปนี้
จากกล่องโต้ตอบนี้ ผู้ใช้สามารถยื่นรายงานต่อ Google สำหรับประเภทปัญหาที่เหมาะสมได้ เช่น ผู้ใช้สามารถรายงานคำหยาบคาย การกลั่นแกล้ง หรือปัญหาทางกฎหมายเกี่ยวกับเนื้อหาได้
แสดงลิงก์การรายงานเนื้อหา
ช่อง flagContentUri มีอยู่ในออบเจ็กต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการตอบกลับ Places API (ใหม่) อยู่แล้ว
ReviewPhotoGenerativeSummaryNeighborhoodSummaryEvChargeAmenitySummaryReviewSummaryContextualContent
คุณต้องแสดงลิงก์การรายงานเนื้อหาเมื่อแสดงออบเจ็กต์เหล่านี้เพื่อให้ลูกค้าสามารถรายงานปัญหาเกี่ยวกับเนื้อหาได้
เข้าถึงลิงก์การรายงานเนื้อหาในคำตอบ
คำขอรายละเอียดสถานที่ (ใหม่) ต่อไปนี้มีรีวิวสถานที่ในการตอบกลับ
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
การตอบกลับจะอยู่ในรูปแบบต่อไปนี้
{
"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"
},
…
]
}แต่ละรายการในอาร์เรย์ reviews จะมีช่อง flagContentUri ซึ่งรวมถึงตัวระบุที่ไม่ซ้ำกันสำหรับรีวิวนั้นๆ การไปยังลิงก์ดังกล่าวจะช่วยให้ลูกค้าสามารถรายงานเนื้อหาที่ไม่เหมาะสมสำหรับรีวิวนั้นๆ ได้
หากคุณใส่ photos ในมาสก์ฟิลด์ ให้ทำดังนี้
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
การตอบกลับยังมีอาร์เรย์ photos ซึ่งแต่ละองค์ประกอบมีฟิลด์ 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"
},
...
]การหมดอายุของลิงก์
ลิงก์เนื้อหาจะยังคงใช้งานได้จนกว่าจะมีการนำเนื้อหาที่ลิงก์ออก ลิงก์จะยังคงเปิดกล่องโต้ตอบสำหรับเนื้อหาที่ถูกนำออกไปแล้ว แต่การยื่นรายงานเกี่ยวกับเนื้อหาที่ถูกนำออกไปแล้วจะไม่มีผลใดๆ
ลองใช้งาน
โปรแกรมสำรวจ API ช่วยให้คุณสร้างคำขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API ได้
เลือกไอคอน API
ทางด้านขวาของหน้าหรือจะขยายแสดงพารามิเตอร์มาตรฐาน แล้วตั้งค่าพารามิเตอร์
fieldsเป็นมาสก์ฟิลด์ก็ได้แก้ไขเนื้อหาคำขอ (ไม่บังคับ)
เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนขยาย
เพื่อขยายหน้าต่างโปรแกรมสำรวจ API