AI 기반 지역 요약

AI 기반 지역 요약은 장소 주변 지역을 대상으로 생성됩니다. 지역 요약은 사용자가 어디를 가고 도착한 후 무엇을 할지 더 정확한 정보를 바탕으로 결정할 수 있도록 주변 관심 장소를 비롯한 위치에 관한 추가 맥락을 제공합니다.

예를 들어 새로운 도시를 방문할 때 호텔에 대해 생성된 주변 환경 요약을 확인하여 주변 지역에 관해 자세히 알아볼 수 있습니다.

  • "북비치와 차이나타운이 조화를 이루는 활기찬 샌프란시스코 지역으로, 금융 지구의 북서쪽에 위치하며 문학적 명소, 독특한 문화 명소, 다양한 음식을 즐길 수 있습니다. 유명한 시티라이츠 서점, 매력적인 케이블카 박물관, 활기찬 차이나타운 거리 등이 이곳의 주요 명소입니다.

    이 지역은 역사와 문화가 독특하게 조화를 이루고 있으며, 구릉과 인파가 있음에도 불구하고 보행자 친화적인 환경에서 탐색을 즐길 수 있습니다. 시티라이츠 서점에서 문학의 역사에 푹 빠져보거나 사원과 운세 쿠키 공장이 있는 차이나타운의 활기찬 문화를 경험해 보세요. 케이블카 박물관에서 과거로 시간 여행을 떠나보세요. 정통 중국 요리부터 맛있는 피자까지 다양한 식사 옵션을 즐기실 수 있습니다."

전기자동차 충전을 고려하고 있다면 생성된 전기자동차 충전소 요약을 확인하여 기다리는 동안 방문할 근처 카페나 음식점을 찾을 수 있습니다.

  • "이 지역에는 스타벅스, 스시 진, 세이프웨이 등 다양한 음식점이 도보 9분 거리에 있습니다."

응답에는 지역 설명과 함께 설명에 언급된 장소의 장소 ID 목록도 포함됩니다.

Places API (신규)는 다음과 같은 두 가지 유형의 AI 기반 지역 요약을 제공합니다.

  • 이웃 요약: premise, street_address 유형의 장소 및 주택 및 숙박 카테고리의 모든 유형의 장소에 대한 주변 명소의 개요를 제공합니다.
  • electric_vehicle_charging_station 유형의 장소에 대한 주변 관광 명소의 개요를 제공하는 전기자동차 충전소 (EVCS) 편의시설 요약

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

주변 환경 요약 요청

주택 및 숙박 시설 카테고리의 유형이 있는 장소에 대해 주변 환경 요약을 생성할 수 있습니다. 응답에 주변 환경 요약을 반환하려면 요청의 필드 마스크에 다음을 포함합니다.

  • 장소 세부정보 (신규): neighborhoodSummary
  • 텍스트 검색 (신규) 및 주변 검색 (신규): places.neighborhoodSummary

응답의 장소에 대한 neighborhoodSummary 필드에는 다음이 포함됩니다.

  • 두 개의 하위 필드: overview 및 description overview 하위 필드에는 장소와 관련된 주변 관심 장소가 포함되며 description 하위 필드는 주변 지역에 관한 더 일반적인 정보를 제공합니다. 각 하위 필드에는 참조된 장소 리소스 이름 목록이 place/PLACE_ID 형식으로 포함됩니다.
  • 사용자가 생성된 요약의 문제를 신고할 수 있는 flagContentUri 링크입니다.
  • 저작자 표시에 통합되어야 하는 'Gemini로 요약됨'이라는 공개 문구가 포함된 현지화된 텍스트 문자열입니다.

다음 예는 뉴욕시의 호텔에 대한 주변 환경 요약을 요청합니다.

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

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

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

EVCS 편의시설 요약 요청

유형이 electric_vehicle_charging_station인 장소의 경우 전기자동차 충전소 (EVCS) 편의시설 요약을 생성할 수 있습니다. 응답에 EVCS 편의시설 요약을 포함하려면 요청의 필드 마스크에 다음을 포함하세요.

  • 장소 세부정보 (신규): evChargeAmenitySummary
  • 텍스트 검색 (신규) 및 주변 검색 (신규): places.evChargeAmenitySummary

응답의 장소에 대한 evChargeAmenitySummary 필드에는 다음이 포함됩니다.

  • 하위 필드 4개(overview, coffee, restaurant, store) 각 하위 필드에는 주변 관심 장소에 관한 간단한 설명과 참조된 장소 리소스 이름 목록(place/PLACE_ID 형식)이 포함됩니다.
  • 사용자가 생성된 요약의 문제를 신고할 수 있는 flagContentUri 링크입니다.
  • 저작자 표시에 통합되어야 하는 'Gemini로 요약됨'이라는 공개 문구가 포함된 현지화된 텍스트 문자열입니다.

다음 예에서는 마운틴뷰의 충전소에 대한 전기자동차 충전소 편의시설 요약을 요청합니다.

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

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

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

기여 분석

앱에 표시되는 모든 AI 기반 요약에는 Google의 정책 및 표준에 따라 적절한 저작자 표시가 포함되어야 합니다. 자세한 내용은 장소 API 정책을 참고하세요.