AI 기반 지역 요약

장소 주변 지역에 대한 AI 기반 지역 요약이 생성됩니다. 지역 요약은 근처 관심 장소를 비롯한 위치에 관한 추가 컨텍스트를 제공하므로 사용자는 어디로 가야 할지, 도착한 후 무엇을 해야 할지 더 많은 정보를 바탕으로 결정할 수 있습니다.

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

  • "샌프란시스코의 이 활기찬 지역은 노스 비치와 차이나타운이 어우러져 있으며, 파이낸셜 디스트릭트의 북서쪽에 위치하고 있습니다. 문학적 명소, 독특한 문화적 명소, 다양한 식당이 있습니다. 유명한 명소로는 상징적인 시티 라이츠 서점, 매력적인 케이블카 박물관, 번화한 차이나타운 거리가 있습니다.

    이 지역은 역사와 문화가 독특하게 어우러진 곳으로, 언덕과 인파가 있지만 보행자 친화적인 환경 덕분에 탐험하기에 좋습니다. 시티 라이츠 서점에서 문학사에 빠져들고, 사원과 포춘 쿠키 공장이 있는 차이나타운의 활기찬 문화를 경험하거나, 케이블카 박물관에서 과거로 시간 여행을 떠나보세요. 정통 중국 요리부터 맛있는 피자까지 다양한 식사 옵션이 준비되어 있습니다."

전기자동차 충전을 고려 중인 경우 전기자동차 충전소에 대해 생성된 요약을 확인하여 기다리는 동안 방문할 수 있는 주변 카페나 레스토랑을 찾을 수 있습니다.

  • "이 지역에는 스타벅스, 스시 진, 세이프웨이 등 도보 9분 이내에 다양한 식사 옵션이 있습니다."

응답에는 지역에 대한 설명과 함께 설명에서 참조된 장소의 장소 ID 목록도 포함됩니다.

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

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

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

지역 요약은 다음 언어 및 지역의 관심 지점에 지원됩니다.

언어 리전
영어 미국

지역 요약 요청하기

premise, street_address 유형의 장소와 주택 및 숙박 카테고리의 모든 유형에 대해 주변 지역 요약을 생성할 수 있습니다. 응답에 인근 지역 요약을 반환하려면 요청의 필드 마스크에 다음을 포함합니다.

  • 장소 세부정보 (신규): 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 편의시설 요약 요청

전기자동차 충전소 (EVCS) 편의시설 요약은 유형이 electric_vehicle_charging_station인 장소에 대해 생성할 수 있습니다. 응답에 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의 정책 및 표준에 따라 적절한 저작자 표시가 수반되어야 합니다. 자세한 내용은 Places API 정책을 참고하세요.