Places API의 Gemini 모델 기능

Places API용 Gemini 모델 기능 (신규)을 사용하면 Places API에 LLM 지원이 제공되므로 LLM에서 제공하는 데이터와 함께 장소와 관련된 데이터(영업시간, 리뷰, 사진)를 반환할 수 있습니다. 이 생성형 데이터에는 이미 장소와 연결된 데이터를 개선하기 위해 LLM에서 집계 및 요약된 데이터가 포함되어 있습니다.

예를 들어 '전기자동차 충전소'에 대한 표준 텍스트 검색 (신규)을 사용하면 전기자동차 충전을 제공하는 장소 목록이 반환됩니다. 가장 가까운 전기차 충전소 또는 내 차량과 호환되는 가장 가까운 충전소를 찾고 있는 경우 이 유형의 대답이 적합합니다.

하지만 충전소 주변 지역을 더 잘 이해하는 것도 좋습니다. 특히 차량이 충전되는 동안 1시간 이상 머물 예정인 경우 더욱 그렇습니다. 동일한 검색에 Gemini 모델 기능을 사용하는 경우 응답에는 충전소 주변 지역 정보를 비롯하여 응답의 각 장소에 관한 동적 생성 설명이 포함될 수 있습니다.

  • "도보 2~4분 거리에 Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch 등의 식당과 쇼핑 옵션이 여러 곳 있으며 Walmart, Whole Foods Market, Trader Joe's 등의 여러 식료품점도 있습니다."

  • "도보 1~5분 거리에 Khao Kang Thai Kitchen, Roger's Deli & Donuts, La Costeña 등 다양한 식당과 쇼핑 옵션이 있습니다. 스시의 경우 Joy Sushi가 좋습니다. 식료품의 경우 Dollar Tree에서 다양한 제품을 할인가에 제공합니다."

LLM의 생성형 콘텐츠는 대답을 개선하고 사용자가 충분한 정보를 바탕으로 결정을 내릴 수 있도록 추가 정보를 제공합니다.

Places API에 새로운 AI 기반 기능이 추가됨 (신규)

이 기능은 Places API (신규) 응답에 다음 데이터를 추가합니다.

생성형 장소 요약

생성형 장소 요약은 장소 ID에 따라 다릅니다. 장소 요약은 여러 유형의 데이터를 장소의 단일 요약으로 집계합니다.

Places API (신규)는 두 가지 유형의 생성형 장소 요약을 제공합니다.

  • 개요 요약: 사용자가 장소에 대한 개요를 파악하는 데 도움이 되는 장소에 대한 간단한 개요로, 평균 100자(영문 기준) 정도입니다.

  • 설명 요약: 장소의 주요 측면을 다루는 자세한 개요를 제공하는 장소의 요약으로, 평균 400자(영문 기준) 정도입니다.

장소 요약은 현재 문화, 엔터테인먼트 및 레크리에이션, 음식 및 음료, 쇼핑, 스포츠 카테고리의 지원되는 유형에 표시된 장소 유형에 사용할 수 있습니다.

생성형 지역 요약

생성형 지역 요약은 장소 주변의 근처 지역을 위해 LLM에서 생성합니다. 장소의 지역 요약에는 사용자가 지역 세부정보를 드릴다운하기 위해 추가 요청을 하지 않아도 사용자가 결정을 내리는 데 필요한 모든 정보가 포함될 수 있습니다.

응답에는 지역 설명과 함께 설명에 언급된 장소의 장소 ID 목록과 다양한 콘텐츠 유형별로 정렬된 장소 목록도 포함됩니다. 예를 들어 한 콘텐츠 유형에는 해당 지역의 활동과 관련된 장소 목록이 포함되고 다른 콘텐츠 유형에는 해당 지역의 음식점 목록이 포함됩니다.

현재 지역 요약은 숙박 시설 카테고리의 지원되는 유형에 표시된 장소 유형과 특정 장소 유형인 electric_vehicle_charging_station, geocode, premise에 사용할 수 있습니다.

장소 및 지역 요약 생성

생성형 장소 요약과 생성형 지역 요약은 모두 Google에서 오프라인으로 자주 생성합니다. 이러한 요약을 오프라인에서 생성하면 Gemini를 기반으로 하는 콘텐츠를 활용하면서도 이미 예상한 대로 Places API (신규)에서 동일한 실적을 확인할 수 있습니다.

Google은 사용 가능한 최신 정보를 바탕으로 이러한 요약을 자주 재생성하여 최신 상태를 유지합니다. 즉, API를 호출할 때 서비스에 최신 데이터가 표시됩니다.

문맥 검색 결과

텍스트 검색(신규)은 문자열(예: '뉴욕의 피자' 또는 '오타와 근처의 신발 가게')을 기반으로 일련의 장소에 대한 정보를 반환하는 웹 서비스입니다. 텍스트 검색(신규) 응답에는 텍스트 문자열과 일치하는 장소 목록과 요청에 설정된 위치 편중이 포함됩니다.

응답에 문맥 검색 결과를 추가하면 이제 응답에 사용자가 질문에 답하는 데 도움이 되는 리뷰, 사진, 근거가 포함됩니다.

  • 검색 결과에 이 장소가 표시되는 이유는 무엇인가요?
  • 이 장소를 선택해야 하는 이유는 무엇인가요?

예를 들어 오늘 Place Details (신규), Text Search (신규) 또는 Nearby Search (신규)를 요청하여 응답에 특정 장소를 포함합니다. 반환된 데이터가 장소와 연결되어 있으므로 장소의 응답 데이터는 세 가지 요청 모두에서 동일합니다.

그러나 새 기능을 사용하는 텍스트 검색 (신규)의 경우 응답에 입력 쿼리 문자열 자체에서 파생된 데이터가 포함될 수 있습니다. 즉, 문맥 검색 결과는 쿼리 문자열마다 고유합니다. 예를 들어 다음 쿼리 문자열을 사용하여 Text Search (신규) 요청을 실행합니다.

"캘리포니아 마운틴뷰에 있는 매운 채식주의자 레스토랑"

그런 다음 모든 입력 매개변수를 동일하게 두고 쿼리 문자열만 다음과 같이 변경합니다.

'캘리포니아 마운틴뷰에 있는 매운 비건 레스토랑'

두 응답에 모두 표시되는 음식점의 경우 장소에 관한 응답 데이터는 장소 자체와 연결되어 있으므로 동일합니다. 하지만 문맥 검색 결과는 쿼리 문자열에서 파생되므로 쿼리에 고유합니다. 그런 다음 문맥 검색 결과의 리뷰, 사진, 근거를 사용자에게 표시하여 사용자가 응답 중 검색 요청에 가장 적합한 장소를 결정할 수 있도록 지원할 수 있습니다.

Places API에 Gemini 모델 기능 사용 설정 (신규)

Places API (신규)의 Gemini 모델 기능을 사용하려면 Places API (신규)를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.

실험용 출시의 제한사항

이 버전은 미국 내 장소의 장소 및 지역 요약을 영어로만 지원합니다.

Gemini란 무엇인가요?

Gemini 모델에 대한 자세한 내용은 Gemini FAQ를 참고하세요.

생성형 장소 요약 요청

장소 요약은 특정 장소에 대해 LLM에서 생성한 생성형 요약입니다. Places API (신규)는 응답에 다음 두 가지 유형의 요약을 추가합니다.

  • 개요 장소와 연결된 정적 편집 요약과 유사한 생성형 요약입니다. 생성형 짧은 요약(평균 약 100자)에는 다음과 같은 몇 가지 이점이 있습니다.

    • 많은 장소에는 편집 요약이 없으므로 장소에 대한 정보의 공백을 메웁니다.

    • LLM에서 생성되므로 장소 소유자가 이를 유지관리할 필요가 없습니다.

  • 설명 생성형 요약은 Google 지도의 리뷰를 비롯한 여러 소스에서 파생됩니다. 평균 400자 정도의 설명에는 긴 설명을 생성하는 데 사용된 리뷰 목록이 포함됩니다.

    설명 요약을 수동으로 생성하려면 사람이 여러 위치에서 데이터를 수집한 후 콘텐츠를 직접 제작하고 유지해야 합니다. Places API용 Gemini 모델 기능 (신규)은 생성된 콘텐츠의 범위와 최신성을 유지하기 위해 LLM에서 이러한 요약을 생성합니다.

장소 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 검색 (신규)에서 지원됩니다. 응답에 장소 요약을 포함하려면 요청의 필드 마스크에 다음 필드를 포함합니다.

  • 장소 세부정보: generativeSummary

  • 텍스트 검색 및 주변 검색: places.generativeSummary

generativeSummary 필드에는 다음 필드가 포함됩니다.

  • generativeSummary.overview: 생성형 개요 요약입니다.
  • generativeSummary.description: 생성형 설명 요약입니다.
  • generativeSummary.references: 설명 요약의 콘텐츠를 제공하는 데 사용되는 최대 5개의 리뷰 배열입니다. 설명 요약이 없으면 이 배열은 비어 있습니다.
  • overviewFlagContentUri: 사용자가 개요 요약의 문제를 신고할 수 있는 링크입니다.
  • descriptionFlagContentUri: 사용자가 설명 요약에 문제가 있다고 신고할 수 있는 링크입니다.

개요 및 설명 요약 요청 예시

이 예에서는 places.generativeSummary 필드 마스크를 사용하여 generativeSummary.overview, generativeSummary.description, generativeSummary.references 필드를 포함한 전체 generativeSummary 객체를 반환합니다.

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
https://places.googleapis.com/v1/places:searchText

응답의 형식은 다음과 같습니다.

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

개요 요약 요청의 예

이 텍스트 검색 예에서는 캘리포니아 마운틴뷰에 있는 매운 채식 레스토랑의 overview 요약만 반환합니다.

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \
https://places.googleapis.com/v1/places:searchText

응답에는 overview.textoverview.languageCode가 포함된 generativeSummary.overview 필드가 포함됩니다.

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

생성 지역 요약 요청

지역 요약은 장소의 근처 지역을 위해 LLM에서 생성한 생성형 요약입니다. 지역 요약은 사용자가 장소에 관해 결정을 내리는 데 중요할 수 있습니다.

예를 들어 새로운 도시에서 호텔을 예약하려고 하는데 요구사항을 충족하는 호텔을 찾을 수 있지만 호텔 주변 지역에 관해 자세히 알아보고 싶습니다. 주변 지역의 지도를 확인한 후 지도에서 각 장소를 조사하는 대신 호텔의 지역 개요를 생성할 수 있습니다.

지역 요약은 장소 세부정보 (신규), 텍스트 검색 (신규), 주변 지역 검색 (신규)에서 지원됩니다.

응답에 지역 요약을 포함하려면 요청의 필드 마스크에 다음을 포함합니다.

  • areaSummary (장소 세부정보)
  • places.areaSummary (텍스트 검색 및 주변 지역 검색)

응답의 장소에 관한 areaSummary 필드에는 Google에서 삭제할 수 있도록 부적절한 콘텐츠를 신고하는 데 사용할 수 있는 flagContentUri 필드가 포함됩니다. 또한 최대 4개의 contentBlocks 배열도 포함됩니다. 각 블록의 주제는 장소 유형에 따라 다릅니다.

  • electric_vehicle_charging_station 유형의 장소로 정의된 전기자동차 충전소의 경우 주제 블록에는 "overview", "coffee", "restaurant", "store"가 포함됩니다.

  • 숙박 시설 카테고리로 정의된 유형과 특정 장소 유형 geocodepremise이 있는 장소의 경우 주제 블록에는 "overview", "activity", "restaurant", "store"가 포함됩니다.

전기자동차 충전소의 지역 요약 요청 예시

이 Place Details 요청 예시는 장소 ID ChIJC5b6QKiwj4ARgn2EwlnJnWU로 식별되는 마운틴뷰의 특정 전기자동차 충전소에 대한 지역 요약을 반환합니다.

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

응답에는 contentBlocks 배열을 포함하는 areaSummary 필드가 포함됩니다.

  • topic 필드는 콘텐츠 블록의 유형을 지정합니다. 이 예시의 장소는 전기자동차 충전소이므로 4개의 콘텐츠 블록은 "overview", "coffee", "restaurant", "store"입니다.

  • content 필드에는 언어 코드를 포함하여 해당 주제의 요약이 포함됩니다.

  • references 배열은 콘텐츠 블록의 콘텐츠를 제공하는 데 사용되는 장소 리소스 이름(places/PLACE_ID 형식)을 지정합니다.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

호텔의 지역 요약 요청 예시

다음 텍스트 검색 요청 예시에서는 캘리포니아 주 마운틴뷰의 호텔을 요청합니다.

curl -X  POST -d '{
  "textQuery": "Hotels",
  "location_bias":{
    "rectangle":{
      "low": {
        "latitude": 37.415,
       "longitude": -122.091},
    "high":{
      "latitude": 37.429,
      "longitude": -122.065}
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \
https://places.googleapis.com/v1/places:searchText

응답에는 contentBlocks 배열을 포함하는 areaSummary 필드가 포함됩니다. 호텔 유형의 장소에 대한 응답에는 "overview", "activity", "restaurant", "store" 주제의 콘텐츠 블록이 포함됩니다.

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

문맥 검색 결과 요청

텍스트 검색 (신규) 요청에 대한 응답에는 입력 검색 문자열의 기준과 일치하는 장소 배열이 포함됩니다. 이제 API에 입력한 쿼리를 기반으로 응답에서 문맥 검색 데이터를 요청할 수 있습니다.

문맥 요약을 지원하기 위해 텍스트 검색 (신규)의 응답에는 응답의 places 배열과 동일한 수준에 contextualContents라는 새 배열이 포함됩니다.

{
  "places": [],
  "contextualContents":[]
}

contextualContents 배열의 각 요소(ContextualContent 유형)는 places 배열의 장소와 상응하는 배열 위치에 있습니다. 즉, contextualContents[0]의 요소는 places[0]의 장소에 해당합니다.

각 배열 요소에는 다음과 같은 배열 필드가 포함됩니다.

  • contextualContents.reviews: 최대 3개의 리뷰 배열입니다.
  • contextualContents.photos: 최대 5개의 사진 배열입니다.
  • contextualContents.justifications: 장소의 근거 배열입니다. 다음을 포함합니다.

    • reviewJustification: 최종 사용자에게 관심이 있을 수 있는 사용자 리뷰 섹션을 강조 표시합니다.
    • businessAvailabilityAttributesJustification: 최종 사용자에게 관심이 있을 수 있는 비즈니스의 속성을 포함합니다.

응답에 문맥 검색 결과를 포함하려면 텍스트 검색 (신규) 요청의 필드 마스크contextualContents를 포함합니다.

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

응답에는 응답의 각 장소에 대한 contextualContents 배열이 포함됩니다.

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

자동차 사용 사례를 위한 구현 가이드

운전자의 안전을 위해 자동차 환경에서는 주차 모드에서 생성형 AI 요약을 렌더링하는 것이 좋습니다. 운전 모드에서 요약을 렌더링하는 경우 운전자의 주의가 도로로 빠르게 돌아갈 수 있도록 화면 정보는 간단하고 명확하며 간결해야 합니다.

  • 3줄 이하
  • 120자(영문 기준) 이하
  • 최소 전면 크기: 24dp

특히 자동차 관련 맥락에서는 생성형 AI 요약을 안전하고 모든 현지 법규를 준수하는 방식으로 렌더링할 책임이 개발자에게 있습니다.

기여 분석

장소 및 지역 요약을 비롯하여 앱에 리뷰, 사진, 생성형 AI 요약을 표시하는 경우 필요한 저작자 표시도 함께 표시해야 합니다.

생성형 요약의 저작자 표시

장소 및 지역 요약을 비롯하여 앱에 생성형 AI 요약을 표시하는 경우 필요한 저작자 표시도 해야 합니다. 이 섹션에서는 앱에서 생성형 AI 요약을 표시하는 방식에 따라 저작자를 표시하는 방법을 설명합니다.

모든 경우에 저작자 표시는 문장 대소문자를 사용해야 합니다. 저작자 표시 및 Google 로고는 모든 색상, 스타일, 서체 표준을 준수해야 합니다. 이러한 표준에 관한 자세한 내용은 장소 API (신규) 정책을 참고하세요.

다른 Google 데이터의 맥락에 표시된 생성형 AI 요약

이 경우 생성형 AI 저작자 표시는 요약 위 또는 아래에 단독으로 표시될 수 있으며, 다른 위치에 있는 콘텐츠의 Google 저작자 표시를 활용할 수 있습니다.

저작자 표시는 이 이미지와 같이 'AI 요약' 텍스트를 사용하세요.

저작자 표시에는 'AI로 요약됨' 텍스트를 사용합니다.

생성형 AI 요약이 단독으로 표시됨

생성형 AI 요약이 Google 지도의 다른 콘텐츠와 별도로 표시되는 경우 생성형 AI 저작자 표시와 Google 저작자 표시를 구두점으로 구분하여 모두 포함해야 합니다. 저작자 표시는 이 이미지와 같이 'AI 요약' 텍스트와 Google 로고를 사용하세요.

개별적으로 표시되는 요약의 경우 생성형 AI 기여 분석과 Google 기여 분석을 구두점으로 구분하여 포함합니다.

목록에 반복되는 생성형 AI 요약

장소 목록에서 생성형 AI 장소 요약 개요를 반복할 때 다음 조건이 모두 충족되어야 합니다.

  • 목록 콘텐츠에 Google이 저작자로 표시됨
  • 표시되는 요약은 AI 생성입니다.
  • Google에서 콘텐츠를 제공합니다.

저작자 표시는 목록 위 또는 아래에 한 줄로 표시되어야 합니다. AI 저작자 표시는 왼쪽 정렬이고 Google 저작자 표시는 오른쪽 정렬입니다.

목록의 경우 목록 위 또는 아래에 한 줄로 기여 분석을 표시합니다.

목록에 더 긴 형식의 생성형 AI 설명 요약이 사용되는 경우 각 요약에 AI 저작자 표시(정보 아이콘/버튼이 있는 'AI 요약')가 있어야 합니다.

대화상자에 생성형 AI 요약에 관한 정보를 표시합니다.

생성형 AI 요약과 함께 최종 사용자가 요약에 관한 정보를 표시하는 대화상자와 flagContentUri 필드에 포함된 요약의 고유 식별자를 사용하여 문제를 신고할 수 있는 링크를 제공해야 합니다. 생성형 AI 설명 요약을 사용할 때는 요약의 출처에 관한 정보(참조)를 포함해야 합니다.

AI 저작자 표시 (위 예시 참고)와 함께 정보 아이콘 (상호작용 어포던스)을 포함하고 AI 저작자 표시 영역과 아이콘이 눌리거나 클릭될 때 반응하도록 하여 이 대화상자에 대한 액세스를 사용 설정합니다.

생성된 장소 요약의 경우 다음을 표시합니다.

정보 AI 장소 요약은 Google 리뷰 및 기타 데이터에서 생성됩니다.
문제 신고 요약 콘텐츠에 관한 문제를 Google에 신고하려면 flagContentUri 필드에 포함된 링크를 사용하세요.
참조 소스 검토

예를 들면 다음과 같습니다.

대화상자에 생성형 AI 요약에 관한 정보를 표시합니다.

생성 지역 요약의 경우 다음을 표시합니다.

정보 AI 지역 요약은 Google 리뷰 및 로컬 데이터에서 생성됩니다.
문제 신고 요약 콘텐츠에 관한 문제를 Google에 신고하려면 flagContentUri 필드에 포함된 링크를 사용하세요.

지역 요약 저작자 표시