Places API는 응답에 장소에 관한 정보를 반환합니다. 응답에는 주소 및 전화번호와 같은 사실적 콘텐츠와 함께 사용자가 Google 지도에 제공한 콘텐츠(예: 리뷰, 사진)도 포함될 수 있습니다. 또한 Places API에 Gemini 모델 기능을 사용하는 경우 응답에 LLM에서 집계 및 요약된 생성형 데이터가 포함될 수 있습니다.
Google은 문제가 있는 콘텐츠가 Places API에서 반환되기 전에 이를 식별하기 위한 일련의 조치를 구현했지만 사용자가 Google에서 삭제할 수 있도록 부적절한 콘텐츠를 신고할 수 있는 방법도 제공합니다. 이번 출시에서는 Places API 응답에 포함된 모든 리뷰, 사진, 생성형 요약에 새로운 flagContentUri 필드가 포함됩니다. 이 필드에는 사용자가 Google에 부적절한 콘텐츠를 신고할 수 있는 고유 콘텐츠 식별자를 포함한 링크가 포함되어 있습니다.
예를 들어 장소에 대한 개별 리뷰 5개를 반환하는 요청을 보냅니다. 각 개별 리뷰에는 사용자가 일부 또는 모든 리뷰에 관한 문제를 신고할 수 있도록 해당 리뷰의 고유 식별자가 포함된 새 flagContentUri 필드가 포함됩니다.
API 탐색기를 사용하면 실시간으로 요청하여 다음과 같은 새로운 옵션을 익힐 수 있습니다.
링크 형식
flagContentUri 필드에 포함된 URL에는 콘텐츠의 고유 식별자가 포함됩니다. 이 링크를 탐색하면 다음과 같은 형식의 Google 호스팅 웹페이지가 열립니다.
이 대화상자에서 사용자는 적절한 문제 유형에 대해 Google에 신고할 수 있습니다. 예를 들어 욕설, 괴롭힘 또는 콘텐츠와 관련된 법적 문제를 신고할 수 있습니다.
가격 책정
이 기능은 GA 이전 미리보기 단계에 있으며 미리보기 기간 동안에는 사용 요금이 청구되지 않으므로 청구 금액은 0달러입니다. 제안된 가격에 관한 자세한 내용은 Places API 사용량 및 결제를 참고하세요.
콘텐츠 신고 링크 표시
이 미리보기 출시에서는 이미 Places API 응답의 일부인 다음 객체에 새 flagContentUri 필드를 추가합니다.
ReviewPhotoGenerativeSummaryGenerativeSummary의 경우 두 가지 새로운 필드가 있습니다.overviewFlagContentUri: 개요에서 Google에 부적절한 콘텐츠를 신고할 수 있는 링크입니다.descriptionFlagContentUri: 설명에 부적절한 콘텐츠가 있음을 Google에 알리는 링크입니다.
미리보기 기간에는 이러한 객체를 고객에게 표시할 때 콘텐츠 신고 링크를 표시할 필요가 없습니다.
그러나 이 기능이 정식 버전 (GA)으로 전환되면 고객이 콘텐츠 문제를 신고할 수 있도록 이러한 객체를 표시할 때 콘텐츠 신고 링크를 표시해야 합니다.
응답에서 콘텐츠 신고 링크에 액세스
다음 장소 세부정보 요청에는 응답에 장소 리뷰가 포함됩니다.
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
응답에는 각 요소에 flagContentUri 필드가 포함된 photos 배열도 포함됩니다.
...
"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 탐색기 창을 펼칩니다.