Places API (신규)는 응답에서 장소에 대한 정보를 반환합니다.
주소, 전화번호와 같은 사실적 콘텐츠와 함께 리뷰, 사진 등 사용자가 Google 지도에 제공한 콘텐츠도 대답에 포함될 수 있습니다. 또한 Places API (신규)용 Gemini 모델 기능을 사용하면 LLM에서 집계되고 요약된 생성형 데이터가 응답에 포함될 수 있습니다.
Google에서는 Places API (New)에서 반환되기 전에 문제가 있는 콘텐츠를 식별하기 위해 일련의 조치를 구현했지만, Google에서 삭제할 수 있도록 사용자가 부적절한 콘텐츠를 신고할 수 있는 방법도 제공합니다. 이번 출시를 통해 Places API (New)에는 Places API (New) 응답에 포함된 모든 리뷰, 사진, 생성형 요약에 새로운 flagContentUri 필드가 포함됩니다. 이 필드에는 사용자가 Google에 부적절한 콘텐츠를 알릴 수 있는 링크(고유 콘텐츠 식별자 포함)가 포함되어 있습니다.
예를 들어 장소에 대한 개별 리뷰 5개를 반환하는 요청을 합니다. 각 개별 리뷰에는 사용자가 일부 또는 모든 리뷰에 대해 문제를 신고할 수 있도록 해당 리뷰의 고유 식별자가 포함된 새로운 flagContentUri 필드가 포함됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003eThe Places API now includes a \u003ccode\u003eflagContentUri\u003c/code\u003e field in reviews, photos, and generative summaries, enabling users to report inappropriate content directly to Google.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in Preview and free of charge; billing details for when it reaches General Availability can be found in the Places API Usage and Billing documentation.\u003c/p\u003e\n"],["\u003cp\u003eWhile not mandatory during Preview, displaying the content reporting link will be required upon General Availability to facilitate user reporting of content issues.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eflagContentUri\u003c/code\u003e field contains a unique URL that opens a Google-hosted webpage for users to specify the issue type and submit their report.\u003c/p\u003e\n"],["\u003cp\u003eThese content reporting links will remain functional until the associated content is removed, although reporting on removed content will have no effect.\u003c/p\u003e\n"]]],["The Places API now includes a `flagContentUri` field in reviews, photos, and generative summaries, allowing users to report inappropriate content. This field provides a unique URL for each item, directing users to a Google-hosted page where they can report issues like profanity or bullying. During the pre-GA preview, this feature is free to use, but upon GA release, displaying the content reporting link will become mandatory. The feature can be tested using the API Explorer.\n"],null,["The Places API (New) returns information about a place in a response.\nAlong with factual content, such as an address and phone number, the response\ncan also contain content that users have contributed on Google Maps, such as\nreviews and photos. In addition, when you use [Gemini model capabilities for\nPlaces API (New)](/maps/documentation/places/web-service/experimental/places-generative),\nthe response can include generative data aggregated and summarized from a LLM.\n\nAlthough Google has implemented a series of measures to identify problematic\ncontent before it is returned by the Places API (New), we also provide a\nway for users to flag inappropriate content so that Google can remove it. With\nthis release, the Places API (New) includes the new `flagContentUri` field\nin all reviews, photos, and generative summaries included in a\nPlaces API (New) response. This field contains a link, including a unique\ncontent identifier, that lets users notify Google of inappropriate content.\n\nFor example, you make a request that returns five individual reviews for a\nplace. Each individual review includes the new `flagContentUri` field with a\nunique identifier for that review so that a user can report an issue with any or\nall of the reviews.\n\nThe API Explorer lets you make live requests so that you can get familiar with\nthese new options:\n\n[Try it!](#try-it)\n\nLink format\n\nThe URL contained in the `flagContentUri` field includes a unique identifier for\nthe content. Browsing to this link opens a Google-hosted web page in the form:\n\nFrom this dialog, your users can file a report with Google for the appropriate\nissue type. For example, they can report profanity, bullying, or a legal issue\nwith the content.\n\nDisplay the content reporting link\n\nThe `flagContentUri` field is available in the following objects that are\nalready part of the Places API (New) response:\n\n- [`Review`](/maps/documentation/places/web-service/reference/rest/v1/places#review)\n- [`Photo`](/maps/documentation/places/web-service/reference/rest/v1/places#photo)\n- [`GenerativeSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#generativesummary)\n- [`NeighborhoodSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#neighborhoodsummary)\n- [`EvChargeAmenitySummary`](/maps/documentation/places/web-service/reference/rest/v1/places#evchargeamenitysummary)\n- [`ReviewSummary`](/maps/documentation/places/web-service/reference/rest/v1/places#reviewsummary)\n- [`ContextualContent`](/maps/documentation/places/web-service/reference/rest/v1/places/searchText#ContextualContent)\n\nYou must display the content reporting link when you display these objects so\nthat your customers can report any content issues.\n\nAccess the content reporting link in the response **Note:** See the [Gemini model capabilities for\n| Places API (New)](/maps/documentation/places/web-service/experimental/places-generative) for examples using `GenerativeSummary`, `NeighborhoodSummary`, `EvChargeAmenitySummary`, and `ReviewSummary`.\n\nThe following Place Details (New) request includes place reviews in the\nresponse: \n\n```\ncurl -X GET -H 'Content-Type: application/json' \\\n-H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: id,displayName,reviews\" \\\nhttps://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw\n```\n\nThe response is in the form:\n**Note:** The example URLs shown in the responses below are placeholders for real content URLs and cannot be used to report an issue. \n\n```text\n{\n \"id\": \"ChIJj61dQgK6j4AR4GeTYWZsKWw\",\n \"displayName\": {\n \"text\": \"Googleplex\",\n \"languageCode\": \"en\"\n },\n \"reviews\": [\n {\n \"name\": \"places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB\",\n \"relativePublishTimeDescription\": \"7 months ago\",\n \"rating\": 3,\n \"text\": {\n \"text\": \"Came here for a tour and honestly,...\",\n \"languageCode\": \"en\"\n },\n \"originalText\": {\n \"text\": \"Came here for a tour and honestly,...\",\n \"languageCode\": \"en\"\n },\n \"authorAttribution\": {\n \"displayName\": \"John Smith\",\n \"uri\": \"https://www.google.com/maps/contrib/10198693/reviews\",\n \"photoUri\": \"https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6\"\n },\n \"publishTime\": \"2024-02-24T19:26:18.091264Z\",\n \"flagContentUri\": \"https://www.google.com/local/review/rap/report?postId=CJ2&t=1\",\n \"googleMapsUri\": \"https://www.google.com/maps/reviews/data=!4m6!14m5\"\n },\n …\n ]\n}\n```\n\nEach entry in the `reviews` array contains the `flagContentUri` field, including\na unique identifier for that specific review. Browsing to that link lets your\ncustomers report inappropriate content for that specific review.\n\nIf you include `photos` in the field mask: \n\n```\ncurl -X GET -H 'Content-Type: application/json' \\\n-H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: id,displayName,reviews,photos\" \\\nhttps://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw\n```\n\nThe response also includes the `photos` array where each element contains the\n`flagContentUri` field: \n\n```scdoc\n ...\n \"photos\": [\n {\n \"name\": \"places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo\",\n \"widthPx\": 4032,\n \"heightPx\": 3024,\n \"authorAttributions\": [\n {\n \"displayName\": \"Jane Smith\",\n \"uri\": \"https://maps.google.com/maps/contrib/107007354\",\n \"photoUri\": \"https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo\"\n }\n ],\n \"flagContentUri\": \"https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr\",\n \"googleMapsUri\": \"https://www.google.com/maps/reviews/data=!4m6!14m5\"\n },\n ...\n ]\n```\n\nLink expiration\n\nThe content links remain active until the backing content is removed. The links\ndo continue to open the dialog for content that has been removed, but filing a\nreport on content that has already been removed has no effect.\n\nTry it!\n\nThe API Explorer lets you make sample requests so that you can get familiar with\nthe API and the API options.\n\n1. Select the API icon, , on the right\n side of the page.\n\n2. Optionally expand **Show standard parameters** and set **the `fields`\n parameter** to the [field\n mask](/maps/documentation/places/web-service/choose-fields).\n\n3. Optionally edit the **Request body**.\n\n4. Select **Execute** button. In the dialog, choose the account that you want\n to use to make the request.\n\n5. In the API Explorer panel, select the expand icon, , to expand the API Explorer window.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e"]]
을 선택합니다.
을 선택하여 API 탐색기 창을 펼칩니다.