Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir yerin çevresindeki alan için yapay zeka destekli alan özetleri oluşturulur. Bölge özetleri, yakındaki ilgi çekici yerler de dahil olmak üzere bir konumla ilgili ek bağlam sağlar. Böylece kullanıcılar, nereye gidecekleri ve gittiklerinde ne yapacakları konusunda daha bilinçli kararlar verebilir.
Örneğin, yeni bir şehri ziyaret ederken otelin bulunduğu bölge hakkında daha fazla bilgi edinmek için oluşturulan bir mahalle özetini görüntüleyebilirsiniz:
"San Francisco'da North Beach ve Chinatown'ı bir araya getiren bu hareketli bölge, Finans Bölgesi'nin kuzeybatısında yer alır. Burada edebiyatla ilgili önemli yerler, benzersiz kültürel cazibe merkezleri ve çeşitli restoranlar bulunur. Önemli yerler arasında ikonik City Lights Bookstore, büyüleyici Cable Car Museum ve Chinatown'un hareketli sokakları yer alır.
Bölge, tarih ve kültürün benzersiz bir karışımını sunar. Yaya dostu ortam, bazı tepeler ve kalabalıklar olmasına rağmen keşfe davet eder. City Lights Bookstore'da edebiyat tarihine dalın, tapınakları ve fal kurabiyesi fabrikalarıyla Çin Mahallesi'nin canlı kültürünü deneyimleyin veya Cable Car Museum'da zamanda yolculuk yapın. Gerçek Çin mutfağından lezzetli pizzaya kadar çeşitli yemek seçenekleri sizi bekliyor."
Elektrikli araç şarj etmeyi düşünüyorsanız yakındaki kafeleri veya beklerken ziyaret edebileceğiniz restoranları bulmak için elektrikli araç şarj istasyonuyla ilgili oluşturulan özeti görüntüleyebilirsiniz:
"Bu bölgede Starbucks, Sushi Jin ve Safeway gibi 9 dakikalık yürüme mesafesinde çeşitli yemek seçenekleri sunulmaktadır."
Yanıtta, bölgenin açıklamasının yanı sıra açıklamada bahsedilen yerlerin yer kimliklerinin listesi de yer alır.
Places API (Yeni), iki tür yapay zeka destekli alan özeti sunar:
premise, street_address türündeki yerler ve Konut ile Konaklama kategorilerindeki tüm türler için yakındaki ilgi çekici yerlere ilişkin üst düzey genel bakışlar sunan mahalle özetleri.
Elektrikli araç şarj istasyonu (EVCS) olanak özetleri: electric_vehicle_charging_station türündeki yerler için yakındaki turistik yerlere dair üst düzey genel bakış bilgileri sağlar.
premise, street_address türündeki yerler ve Konut ile Konaklama kategorilerindeki tüm türler için mahalle özetleri oluşturulabilir. Yanıt olarak bir mahalle özeti döndürmek için isteğinizin alan maskesine aşağıdakileri ekleyin:
Yer Ayrıntıları (Yeni):neighborhoodSummary
Metin Arama (Yeni) ve Yakınlarda Arama (Yeni):places.neighborhoodSummary
Yanıtın bir yerle ilgili neighborhoodSummary alanında şunlar bulunur:
İki alt alan: overview ve description. overview alt alanı, yere özgü yakındaki ilgi çekici yerleri içerirken description alt alanı, çevre bölge hakkında daha genel bilgiler sağlar. Her alt alan, place/PLACE_ID biçiminde referans verilen yer kaynağı adlarının bir listesini içerir.
Kullanıcıların oluşturulan özetle ilgili bir sorunu işaretleyebileceği flagContentUri bağlantısı.
Atıflara eklenmesi gereken, "Gemini ile özetlendi" açıklama metnini içeren yerelleştirilmiş bir metin dizesi.
Aşağıdaki örnekte, New York City'deki bir otel için mahalle özeti isteniyor:
{"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 hizmeti özeti isteğinde bulunma
Elektrikli araç şarj istasyonu (EVCS) tesis özetleri, electric_vehicle_charging_station türündeki yerler için oluşturulabilir. Yanıtın EVCS
olanağı özetini içermesi için isteğinizin alan maskesine aşağıdakileri ekleyin:
Yer Ayrıntıları (Yeni):evChargeAmenitySummary
Metin Arama (Yeni) ve Yakınlarda Arama (Yeni):places.evChargeAmenitySummary
Yanıtın bir yerle ilgili evChargeAmenitySummary alanı şunları içerir:
Dört alt alan: overview, coffee, restaurant ve store. Her alt alan, yakındaki ilgi çekici yerlerin kısa bir açıklamasını ve place/PLACE_ID biçiminde referans verilen yer kaynak adlarının bir listesini içerir.
Kullanıcıların oluşturulan özetle ilgili bir sorunu işaretleyebileceği flagContentUri bağlantısı.
Atıflara eklenmesi gereken, "Gemini ile özetlendi" açıklama metnini içeren yerelleştirilmiş bir metin dizesi.
Aşağıdaki örnekte, Mountain View'deki bir şarj istasyonu için elektrikli araç şarj istasyonu olanağı özeti isteniyor:
{"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"}}}
İlişkilendirmeler
Uygulamanızda gösterilen tüm yapay zeka destekli özetlere, Google'ın politikaları ve standartları uyarınca uygun atıf eklenmelidir. Daha fazla bilgi için Places API Politikaları'nı inceleyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-29 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------------------------------\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-------------------------------\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------------\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)."]]