קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
סיכומי אזורים מבוססי-AI נוצרים עבור האזור שמסביב למקום. סיכומי אזורים מספקים הקשר נוסף למיקום, כולל נקודות עניין בקרבת מקום, כדי שהמשתמשים יוכלו לקבל החלטה מושכלת יותר לגבי המקום שאליו הם רוצים להגיע והפעילויות שהם רוצים לעשות שם.
לדוגמה, כשמבקרים בעיר חדשה, אפשר לראות סיכום של השכונה שבה נמצא המלון כדי לקבל מידע נוסף על האזור:
"אזור תוסס בסן פרנסיסקו, שמשלב בין נורת' ביץ' וצ'יינטאון, נמצא מצפון-מערב לרובע הפיננסי וכולל ציוני דרך ספרותיים, אטרקציות תרבותיות ייחודיות ומגוון אפשרויות לסעודה. בין המקומות המפורסמים: חנות הספרים האייקונית City Lights, מוזיאון הרכבל המרתק והרחובות ההומים של צ'יינטאון.
האזור מציע שילוב ייחודי של היסטוריה ותרבות, וסביבה ידידותית להולכי רגל שמעודדת גילוי, למרות כמה גבעות והמוני אנשים. אפשר להתעמק בהיסטוריה הספרותית בחנות הספרים City Lights, לחוות את התרבות התוססת של צ'יינהטאון עם המקדשים ומפעלי העוגיות הסיניות או לחזור אחורה בזמן במוזיאון רכבל. מגוון אפשרויות קולינריות מחכות לכם, החל ממטבח סיני אותנטי ועד לפיצה טעימה".
אם אתם שוקלים לטעון רכב חשמלי, אתם יכולים לראות סיכום שנוצר לגבי תחנת טעינה לרכב חשמלי כדי למצוא בתי קפה או מסעדות בסביבה שאפשר לבקר בהם בזמן ההמתנה:
"באזור הזה יש מגוון אפשרויות לסעודה במרחק של 9 דקות הליכה, כולל סטארבקס, סושי ג'ין וסייפווי".
בנוסף לתיאור האזור, התשובה מכילה גם רשימה של מזהי מקומות של המקומות שמוזכרים בתיאור.
Places API (חדש) מספק שני סוגים של סיכומי אזורים מבוססי-AI:
סיכומים של שכונות, שמספקים סקירה כללית של אטרקציות בקרבת מקום למקומות עם הסוגים premise, street_address וכל הסוגים בקטגוריות Housing ו-Lodging.
סיכומים של השירותים בתחנות טעינה לרכבים חשמליים (EVCS), שכוללים סקירה כללית של אטרקציות בקרבת מקום למקומות מסוג electric_vehicle_charging_station.
אפשר ליצור סיכומים של שכונות למקומות עם הסוגים premise,
street_address וכל הסוגים בקטגוריות דיור ואירוח. כדי להחזיר סיכום של השכונה בתשובה, צריך לכלול את השורה הבאה במסכת השדות של הבקשה:
השדה neighborhoodSummary של מקום בתגובה מכיל את הפרטים הבאים:
שני שדות משנה: overview ו-description. שדה המשנה overview כולל נקודות עניין ספציפיות למקום, ושדה המשנה description מספק מידע כללי יותר על האזור שמסביב. כל שדה משנה כולל רשימה של שמות משאבי מקום שאליהם יש הפניה, בפורמט place/PLACE_ID.
קישור flagContentUri
שבו משתמשים יכולים לסמן בעיה בסיכום שנוצר.
מחרוזת טקסט מותאמת לשוק המקומי עם הטקסט של הגילוי הנאות 'סוכם באמצעות Gemini'
שחובה לכלול בשיוכים.
בדוגמה הבאה מוצגת בקשה לקבלת סיכום של השכונה שבה נמצא מלון בניו יורק:
{"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 בתשובה, צריך לכלול את הפרטים הבאים במסכת השדות של הבקשה:
השדה evChargeAmenitySummary של מקום בתגובה מכיל את הפרטים הבאים:
ארבעה שדות משנה: overview, coffee, restaurant וstore. כל שדה משנה כולל תיאור קצר של מוקדי עניין קרובים ורשימה של שמות משאבים של מקומות שאליהם יש הפניה, בפורמט place/PLACE_ID.
flagContentUri קישור שבו משתמשים יכולים לסמן בעיה בסיכום שנוצר.
מחרוזת טקסט מותאמת לשוק המקומי עם גילוי הנאות 'הסיכום נוצר באמצעות Gemini'
שחובה לכלול בשיוכים.
בדוגמה הבאה מוצגת בקשה לסיכום של שירותים בתחנת טעינה לרכב חשמלי (EV) בתל אביב:
{"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.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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)."]]