Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bản tóm tắt khu vực dựa trên AI được tạo cho khu vực xung quanh một địa điểm. Thông tin tóm tắt về khu vực cung cấp thêm bối cảnh cho một vị trí, bao gồm cả các địa điểm tham quan ở gần đó, để người dùng có thể đưa ra quyết định sáng suốt hơn về nơi nên đến và việc nên làm khi đến đó.
Ví dụ: khi ghé thăm một thành phố mới, bạn có thể xem bản tóm tắt khu vực lân cận được tạo cho một khách sạn để tìm hiểu thêm về khu vực xung quanh:
"Khu vực sôi động này ở San Francisco, nơi giao thoa giữa North Beach và Khu phố người Hoa, nằm ở phía tây bắc của Khu tài chính, có các địa điểm văn học nổi tiếng, điểm tham quan văn hoá độc đáo và ẩm thực đa dạng. Một số địa điểm nổi bật có thể kể đến như hiệu sách City Lights nổi tiếng, Bảo tàng Cáp treo thú vị và những con phố nhộn nhịp của Khu phố Tàu.
Khu vực này có sự kết hợp độc đáo giữa lịch sử và văn hoá, nơi có môi trường thân thiện với người đi bộ, mời gọi khám phá mặc dù có một số đồi và đám đông. Đắm mình trong lịch sử văn học tại hiệu sách City Lights, trải nghiệm nền văn hoá sôi động của khu phố Tàu với các đền thờ và nhà máy bánh quy may mắn, hoặc quay ngược thời gian tại Bảo tàng cáp treo. Nơi đây có nhiều lựa chọn ẩm thực, từ ẩm thực Trung Hoa chính hiệu đến pizza thơm ngon."
Nếu đang cân nhắc việc sạc xe điện, bạn có thể xem thông tin tóm tắt được tạo cho một trạm sạc xe điện để tìm các quán cà phê hoặc nhà hàng gần đó để ghé thăm trong lúc chờ đợi:
"Khu vực này có nhiều lựa chọn ăn uống trong vòng 9 phút đi bộ, bao gồm Starbucks, Sushi Jin và Safeway."
Ngoài nội dung mô tả về khu vực, phản hồi cũng chứa danh sách mã địa điểm cho những địa điểm được đề cập trong nội dung mô tả.
Places API (Mới) cung cấp 2 loại bản tóm tắt khu vực dựa trên AI:
Tóm tắt về khu vực lân cận, cung cấp thông tin tổng quan cấp cao về các điểm thu hút gần đó cho những địa điểm có loại premise, street_address và tất cả các loại trong danh mục Nhà ở và Chỗ ở.
Thông tin tóm tắt về tiện nghi của trạm sạc xe điện (EVCS), cung cấp thông tin tổng quan ở cấp cao về các điểm thu hút lân cận cho những địa điểm có loại electric_vehicle_charging_station.
Yêu cầu cung cấp thông tin tóm tắt về khu vực lân cận
Tóm tắt về khu dân cư có thể được tạo cho những địa điểm có loại premise, street_address và tất cả các loại trong danh mục Nhà ở và Cơ sở lưu trú. Để trả về bản tóm tắt về khu vực lân cận trong phản hồi, hãy thêm nội dung sau vào mặt nạ trường của yêu cầu:
Thông tin chi tiết về địa điểm (Mới):neighborhoodSummary
Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới):places.neighborhoodSummary
Trường neighborhoodSummary cho một địa điểm trong phản hồi chứa những thông tin sau:
Hai trường phụ: overview và description. Trường phụ overview bao gồm các địa điểm yêu thích ở gần, cụ thể cho địa điểm đó, trong khi trường phụ description cung cấp thông tin chung hơn về khu vực xung quanh. Mỗi trường phụ đều có một danh sách tên tài nguyên được tham chiếu ở dạng place/PLACE_ID.
flagContentUri
Đường liên kết mà người dùng có thể gắn cờ vấn đề về bản tóm tắt được tạo.
Một chuỗi văn bản đã bản địa hoá có văn bản công bố "Tóm tắt bằng Gemini" mà bạn phải đưa vào thông tin ghi công.
Ví dụ sau đây yêu cầu cung cấp thông tin tóm tắt về khu vực lân cận cho một khách sạn ở Thành phố New York:
{"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"}}}
Yêu cầu cung cấp thông tin tóm tắt về tiện nghi EVCS
Bạn có thể tạo thông tin tóm tắt về tiện nghi của trạm sạc xe điện (EVCS) cho những địa điểm có loại electric_vehicle_charging_station. Để đưa thông tin tóm tắt về tiện nghi EVCS vào phản hồi, hãy thêm thông tin sau vào mặt nạ trường của yêu cầu:
Thông tin chi tiết về địa điểm (Mới):evChargeAmenitySummary
Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới):places.evChargeAmenitySummary
Trường evChargeAmenitySummary cho một địa điểm trong phản hồi chứa những thông tin sau:
Bốn trường con: overview, coffee, restaurant và store. Mỗi trường phụ đều có một nội dung mô tả ngắn về các địa điểm yêu thích ở gần và một danh sách tên tài nguyên được tham chiếu ở dạng place/PLACE_ID.
Đường liên kết flagContentUri để người dùng có thể gắn cờ vấn đề về bản tóm tắt được tạo.
Một chuỗi văn bản đã bản địa hoá có văn bản công bố "Tóm tắt bằng Gemini" mà bạn phải đưa vào thông tin ghi công.
Ví dụ sau đây yêu cầu thông tin tóm tắt về tiện nghi của trạm sạc xe điện cho một trạm sạc ở Mountain View:
{"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"}}}
Phân bổ
Tất cả bản tóm tắt dựa trên AI xuất hiện trong ứng dụng của bạn đều phải có thông tin ghi nhận quyền tác giả phù hợp theo chính sách và tiêu chuẩn của Google. Để biết thêm thông tin, hãy xem Chính sách đối với Places API.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-09-04 UTC."],[],[],null,["AI-powered area summaries are generated for the area surrounding a place. Area\nsummaries provide additional context for a location, including points of\ninterest nearby, so that users can make a more informed decision about where to\ngo and what to do once they get there.\n\nFor example, when visiting a new city, you can view a generated neighborhood\nsummary for a hotel to learn more about the surrounding area:\n\n- *\"This vibrant area in San Francisco, blending North Beach and Chinatown,\n sits northwest of the Financial District and features literary landmarks,\n unique cultural attractions, and diverse dining. Notable spots include the\n iconic City Lights Bookstore, the fascinating Cable Car Museum, and the\n bustling streets of Chinatown.*\n\n *The area offers a unique blend of history and culture, where a\n pedestrian-friendly environment invites exploration despite some hills and\n crowds. Immerse yourself in the literary history at City Lights Bookstore,\n experience the vibrant culture of Chinatown with its temples and fortune\n cookie factories, or step back in time at the Cable Car Museum. A variety of\n dining options await, from authentic Chinese cuisine to delicious pizza.\"*\n\nIf you are considering charging an electric vehicle, you can view a generated\nsummary for an electric vehicle charging station to find nearby coffee shops or\nrestaurants to visit while you wait:\n\n- *\"This area offers a range of dining options within a 9-minute walk,\n including Starbucks, Sushi Jin, and Safeway.\"*\n\nAlong with a description of the area, the response also contains a list of place\nIDs for the places referenced in the description.\n\nPlaces API (New) provides two types of AI-powered area summaries:\n\n- **Neighborhood summaries** , which provide high-level overviews of nearby attractions for places with types `premise`, `street_address`, and all types in the **[Housing](/maps/documentation/places/web-service/place-types#housing)** and **[Lodging](/maps/documentation/places/web-service/place-types#lodging)** categories.\n- **Electric vehicle charging station (EVCS) amenity summaries** , which provide high-level overviews of nearby attractions for places with type `electric_vehicle_charging_station`.\n\nAI-powered area summaries are supported in\n[Place Details (New)](/maps/documentation/places/web-service/place-details),\n[Text Search (New)](/maps/documentation/places/web-service/text-search),\nand\n[Nearby Search (New)](/maps/documentation/places/web-service/nearby-search).\n\nArea summaries are supported for points of interest in the following languages and regions:\n\n| Language | Region |\n|----------|---------------|\n| English | United States |\n\n**Note:** Area summaries are not guaranteed for all places. \n[Try the AI-powered summaries demoopen_in_new](https://mapsplatform.google.com/gemini-placesapi-demo/)\n\nRequest a neighborhood summary\n\nNeighborhood summaries can be generated for places with types `premise`,\n`street_address`, and all types in the\n**[Housing](/maps/documentation/places/web-service/place-types#housing)** and\n**[Lodging](/maps/documentation/places/web-service/place-types#lodging)**\ncategories. To return a neighborhood summary in the response, include the\nfollowing in the field mask of your request:\n\n- **Place Details (New):** `neighborhoodSummary`\n- **Text Search (New)** and **Nearby Search (New):** `places.neighborhoodSummary`\n\nThe `neighborhoodSummary` field for a place in the response contains the\nfollowing:\n\n- Two subfields: `overview` and `description`. The `overview` subfield includes nearby points of interest specific to the place, while the `description` subfield provides more general information about the surrounding area. Each subfield includes a list of referenced place resource names in the form `place/PLACE_ID`.\n- A [`flagContentUri`](/maps/documentation/places/web-service/content-reporting) link where users can flag a problem with the generated summary.\n- A localized text string with the disclosure text \"Summarized with Gemini\" that must be incorporated in the attributions.\n\nThe following example requests a neighborhood summary for a hotel in New York\nCity: \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,neighborhoodSummary\" \\\n'https://places.googleapis.com/v1/places/ChIJT0DdRo1ZwokRkufwSD-TdGM'\n```\n\nThe response is in the form: \n\n```json\n{\n \"id\": \"ChIJT0DdRo1ZwokRkufwSD-TdGM\",\n \"displayName\": {\n \"text\": \"Courtyard New York Manhattan/SoHo\",\n \"languageCode\": \"en\"\n }\n \"neighborhoodSummary\": {\n \"overview\": {\n \"content\": {\n \"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.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJZd0F3oxZwokRiaEouMZKQ-0\",\n /.../\n ]\n },\n \"description\": {\n \"content\": {\n \"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.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJZd0F3oxZwokRiaEouMZKQ-0\",\n /.../\n ]\n },\n \"flagContentUri\": \"https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12\",\n \"disclosureText\": {\n \"text\": \"Summarized with Gemini\",\n \"languageCode\": \"en-US\"\n }\n }\n}\n```\n\nRequest an EVCS amenity summary\n\nElectric vehicle charging station (EVCS) amenity summaries can be generated for\nplaces with type `electric_vehicle_charging_station`. To include the EVCS\namenity summary in the response, include the following in the field mask of your\nrequest:\n\n- **Place Details (New):** `evChargeAmenitySummary`\n- **Text Search (New)** and **Nearby Search (New):** `places.evChargeAmenitySummary`\n\nThe **evChargeAmenitySummary** field for a place in the response contains the\nfollowing:\n\n- Four subfields: `overview`, `coffee`, `restaurant`, and `store`. Each subfield includes a brief description of nearby points of interest and a list of referenced place resource names in the form `place/PLACE_ID`.\n- A `flagContentUri` link where users can flag a problem with the generated summary.\n- A localized text string with the disclosure text \"Summarized with Gemini\" that must be incorporated in attributions.\n\nThe following example requests an EV charging station amenity summary for a\ncharging station in Mountain View: \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,evChargeAmenitySummary\" \\\n'https://places.googleapis.com/v1/places/ChIJtwHgNNa2j4ARlC8vbI9lLZA'\n```\n\nThe response is in the form: \n\n```json\n{\n \"id\": \"ChIJf8j-4z23j4AR_MQ2-bgMmrY\",\n \"displayName\": {\n \"text\": \"EVgo Charging Station\",\n \"languageCode\": \"en\"\n },\n \"evChargeAmenitySummary\": {\n \"overview\": {\n \"content\": {\n \"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.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJZZR2-j23j4ARi5CXEIAc57Q\",\n /.../\n ]\n },\n \"coffee\": {\n \"content\": {\n \"text\": \"Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJZZR2-j23j4ARi5CXEIAc57Q\"\n ]\n },\n \"restaurant\": {\n \"content\": {\n \"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.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo\",\n /.../\n ]\n },\n \"store\": {\n \"content\": {\n \"text\": \"Rotten Robbie is a chain gas station with a convenience store and a restroom.\",\n \"languageCode\": \"en-US\"\n },\n \"referencedPlaces\": [\n \"places/ChIJA6deFBa3j4AREY0EyTEGhN8\",\n /.../\n ]\n },\n \"flagContentUri\": \"https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12\",\n \"disclosureText\": {\n \"text\": \"Summarized with Gemini\",\n \"languageCode\": \"en-US\"\n }\n }\n}\n```\n\nAttributions\n\nAll AI-powered summaries displayed in your app must be accompanied by the\nappropriate attribution in accordance with Google's policies and standards. For\nmore information, see [Policies for Places\nAPI](/maps/documentation/places/web-service/policies#ai-powered_summaries)."]]
