AI 기반 지역 요약

AI 기반 지역 요약은 장소 주변 지역에 대해 생성됩니다. 지역 요약은 사용자가 목적지에 도착한 후 어디로 가고 무엇을 할지 더 잘 파악할 수 있도록 주변 명소 등 위치에 관한 추가 맥락을 제공합니다.

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

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

    이 지역은 역사와 문화가 독특하게 어우러져 있으며, 언덕과 인파가 있긴 하지만 도보 친화적인 환경 덕분에 둘러보기에 좋습니다. City Lights Bookstore에서 문학의 역사를 살펴보고, 사원과 포춘 쿠키 공장이 있는 차이나타운의 활기찬 문화를 경험하거나, 케이블카 박물관에서 과거로 돌아가 보세요. 정통 중식부터 맛있는 피자까지 다양한 식사 옵션을 즐기실 수 있습니다.'

전기 자동차 충전을 고려 중이라면 생성된 전기 자동차 충전소 요약을 확인하여 기다리는 동안 방문할 수 있는 근처 커피숍이나 레스토랑을 찾을 수 있습니다.

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

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

Places API (New)는 다음과 같은 두 가지 유형의 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 필드에는 다음이 포함됩니다.

  • overview, coffee, restaurant, store의 네 가지 하위 필드 각 하위 필드에는 근처 관심 장소에 관한 간단한 설명과 place/PLACE_ID 형식의 참조된 장소 리소스 이름 목록이 포함됩니다.
  • 사용자가 생성된 요약의 문제를 신고할 수 있는 flagContentUri 링크
  • 출처에 포함해야 하는 공개 텍스트 'Gemini로 요약됨'이 포함된 현지화된 텍스트 문자열입니다.

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

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 정책을 참고하세요.