Places API için Gemini model özellikleri (Yeni), LLM'ler tarafından sağlanan verilerle birlikte bir yerle ilişkili verileri (çalışma saatleri, yorumlar, fotoğraflar) döndürmenize olanak tanıyacak şekilde Places API'ye LLM desteği sunar. Bu üretken veriler, bir yerle ilişkilendirilmiş verileri iyileştirmek için LLM'lerden toplanmış ve özetlenmiş veriler içerir.
Örneğin, "elektrikli araç şarj istasyonları" için yapılan standart bir metin araması (yeni), elektrikli araç şarjı hizmeti sunan yerlerin listesini döndürür. Yalnızca en yakın elektrikli araç şarj cihazını veya aracınızla uyumlu en yakın cihazı arıyorsanız bu tür bir yanıt uygundur.
Ancak, özellikle araç şarj olurken bir saat veya daha uzun süre orada olacaksanız şarj istasyonunun çevresindeki bölgeyi de daha iyi anlamak isteyebilirsiniz. Aynı arama için Gemini model özellikleri kullanıldığında yanıt, şarj istasyonunun çevresindeki alanla ilgili bilgiler de dahil olmak üzere yanıttaki her yerin dinamik, üretken açıklamalarını içerebilir:
"2-4 dakikalık yürüme mesafesinde Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch gibi çeşitli yeme-içme ve alışveriş seçenekleri ve Walmart, Whole Foods Market, Trader Joe's gibi çeşitli marketler bulunmaktadır."
"Khao Kang Thai Kitchen, Roger's Deli & Donuts ve La Costeña gibi çeşitli yeme-içme ve alışveriş seçenekleri 1-5 dakikalık yürüme mesafesindedir. Suşi için Joy Sushi iyi bir seçenektir. Dollar Tree'da indirimli fiyatlarla çeşitli ürünler bulabilirsiniz."
LLM'lerden gelen bu üretken içerik, yanıtı iyileştirir ve kullanıcıların bilinçli bir karar vermelerine yardımcı olacak ek bilgiler sağlar.
Places API'ye AI destekli yeni özellikler eklendi (Yeni)
Bu özellikler, bir Places API (Yeni) yanıtına aşağıdaki verileri ekler:
Belirli bir yerle ilgili üretici yer özetleri. Yer özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakında Arama (Yeni) özellikleri tarafından desteklenir.
Belirli bir yerin çevresindeki alan ile ilgili üretici alan özetleri. Alan özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir.
Bağlamsal arama sonuçları, Metin Arama (Yeni) tarafından desteklenir ve bir yerle doğrudan ilişkilendirilen veriler yerine, istekte iletilen arama dizesine dayalı veriler içerir. Bu veriler, metin aramanın (yeni) yanıtı nasıl belirlediğini anlamanıza yardımcı olur.
Üretken yer özetleri
Üretken yer özetleri, bir yer kimliğine özgüdür. Yer özetleri, birçok farklı veri türünü yer için tek bir özet halinde toplar.
Places API (Yeni), üretken yer özetleri için iki tür sağlar:
Genel bakış özetleri: Kullanıcıların bir yerin anlık görüntüsünü almasına yardımcı olabilecek, ortalama 100 karakter uzunluğunda bir yere genel bakış.
Açıklama özetleri: Bir yerin en önemli özelliklerini kapsayan ayrıntılı bir genel bakış sunan, ortalama 400 karakter uzunluğunda daha uzun özetleridir.
Yer özetleri şu anda Kültür, Eğlence ve Eğlence, Yiyecek ve İçecek, Alışveriş ve Spor kategorilerindeki Desteklenen türler bölümünde gösterilen yer türleri için kullanılabilir.
Üretken alan özetleri
Üretken alan özetleri, LLM tarafından bir yerin yakınındaki alan için oluşturulur. Bir yerin alan özeti, kullanıcının karar vermesi için gereken tüm bilgileri içerebilir. Böylece kullanıcı, alan ayrıntılarına inmek için başka istek göndermek zorunda kalmaz.
Yanıt, alanın açıklamasının yanı sıra açıklamada atıfta bulunulan yerlerin yer kimliklerinin ve farklı içerik türlerine göre sıralanmış yerlerin listesini de içerir. Örneğin, bir içerik türü bölgedeki etkinliklerle ilişkili yerlerin listesini, diğeri ise bölgedeki restoranların listesini içerir.
Alan özetleri şu anda Konaklama kategorisindeki Desteklenen türler bölümünde gösterilen yer türleri ve electric_vehicle_charging_station
, geocode
ve premise
yer türleri için kullanılabilir.
Yer ve alan özetleri oluşturma
Hem üretken yer özetleri hem de üretken alan özetleri Google tarafından sık sık çevrimdışı olarak oluşturulur. Bu özetlerin çevrimdışı olarak oluşturulmasını sağlayarak, Gemini tarafından desteklenen içerikten yararlanırken aynı zamanda Places API (Yeni)'den beklediğiniz performansı elde edebilirsiniz.
Google, bu özetleri mevcut en son bilgilere göre güncel olduklarından emin olmak için sık sık yeniden oluşturur. Bu, API'yi çağırdığınızda hizmetinizde en güncel verileri göstereceğiniz anlamına gelir.
Bağlama dayalı arama sonuçları
Metin Arama (Yeni), bir dizeye dayalı olarak bir dizi yerle ilgili bilgi döndürür. Örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları". Metin Arama (Yeni) yanıtı, metin dizesine eşleşen yerlerin ve istekte ayarlanan konum yanlılığının bir listesini içerir.
Yanıta bağlamsal arama sonuçları eklediğinizde yanıt, kullanıcıların aşağıdaki soruları yanıtlamasına yardımcı olan yorumlar, fotoğraflar ve gerekçeler içerir:
- Sonuçlarda neden bu yeri görüyorum?
- Neden burayı seçmeliyim?
Örneğin, bugün Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındaki Arama (Yeni) için yanıtta belirli bir yer içeren bir istekte bulundunuz. Döndürülen veriler söz konusu yerle ilişkili olduğundan, yer için yanıt verileri üç istek için de aynıdır.
Ancak yeni özellikleri kullanan bir metin arama (yeni) için yanıt, giriş sorgu dizesinin kendisinden türetilen verileri içerebilir. Yani bağlama dayalı arama sonuçları, sorgu dizesine özgüdür. Örneğin, aşağıdaki sorgu dizesini kullanarak bir Metin Arama (Yeni) isteği gönderirseniz:
"Mountain View, CA'da baharatlı vejetaryen restoran"
Ardından tüm giriş parametrelerini aynı bırakıp yalnızca sorgu dizesini şu şekilde değiştirin:
"Mountain View, CA'da baharatlı vegan restoran"
Her iki yanıtta da görünen bir restoran için yerle ilişkili olduğu için yerle ilgili yanıt verileri aynıdır. Ancak bağlama dayalı arama sonuçları, sorgu dizesinden türetildikleri için sorguya özgüdür. Ardından, yanıttaki hangi yerin arama istekleriyle en alakalı olduğuna karar vermelerine yardımcı olmak için kullanıcılarınıza bağlama dayalı arama sonuçlarından yorumları, fotoğrafları ve gerekçeleri gösterebilirsiniz.
Places API için Gemini model özelliklerini etkinleştirme (Yeni)
Places API'de (Yeni) Gemini model özelliklerini kullanmak için Places API'yi (Yeni) etkinleştirmeniz gerekir. Daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.
Deneysel sürümle ilgili kısıtlamalar
Bu sürüm, yalnızca ABD'deki yerlerin İngilizce dilindeki yer ve alan özetlerini destekler.
Gemini nedir?
Gemini modeli hakkında bilgi edinmek için Gemini ile ilgili SSS başlıklı makaleyi inceleyin.
Üretken yer özeti isteme
Yer özetleri, LLM tarafından belirli bir yer için oluşturulan üretken özetlerdir. Places API (Yeni), bir yanıta iki tür özet ekler:
Bir yerle ilişkili statik editoryal özete benzer, üretken Genel bakış özetleri. Ortalama 100 karakter uzunluğundaki üretken kısa özetlerin birkaç avantajı vardır:
Birçok yerde editoryal özet bulunmaz. Bu özetler, bir yerle ilgili bilgi eksikliğini giderir.
Bunlar LLM'den oluşturulur. Bu nedenle, mekan sahibinin bunları korumasına gerek yoktur.
Açıklama üretken özetleri, Google Haritalar'daki yorumlar da dahil olmak üzere birçok kaynaktan elde edilir. Ortalama 400 karakter uzunluğundaki bu açıklama, uzun açıklamayı oluşturmak için kullanılan yorumların listesini içerir.
Açıklama özetlerini manuel olarak oluşturmak için bir kişinin birçok konumdan veri toplaması, ardından içeriği manuel olarak oluşturması ve sürdürmesi gerekir. Places API (Yeni) için Gemini model özellikleri, oluşturulan içeriğin kapsamını ve güncelliğini korumak amacıyla bu özetlerin LLM'lerden oluşturulmasını sağlar.
Yer özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir. Yanıta yer özetini eklemek için isteğin alan maskesine aşağıdaki alanı ekleyin:
Yer Ayrıntıları:
generativeSummary
Metin Arama ve Yakındaki Arama:
places.generativeSummary
generativeSummary
alanında aşağıdaki alanlar bulunur:
generativeSummary.overview
: Üretken modele genel bakış özeti.generativeSummary.description
: Üretken açıklama özeti.generativeSummary.references
: Açıklama özetine içerik sağlamak için kullanılan en fazla beş yorumdan oluşan dizi. Açıklama özeti yoksa bu dizi boştur.overviewFlagContentUri
: Kullanıcıların genel bakış özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.descriptionFlagContentUri
: Kullanıcıların açıklama özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.
Örnek genel bakış ve açıklama özeti isteği
Bu örnekte, generativeSummary.overview
, generativeSummary.description
ve generativeSummary.references
alanları dahil olmak üzere generativeSummary
nesnesinin tamamını döndürmek için places.generativeSummary
alan maskesi kullanılmaktadır:
curl -X POST -d '{ "textQuery": "Spicy Vegetarian Food", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \ https://places.googleapis.com/v1/places:searchText
Yanıt şu biçimdedir:
{ "places": [ { "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts", "displayName": { "text": "Zareen's", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.", "languageCode": "en-US" }, "description": { "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options. Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.", "languageCode": "en-US" }, "references": { "reviews": [ { "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE", "relativePublishTimeDescription": "12 months ago", "rating": 5, "text": { "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!", "languageCode": "en" }, "originalText": { "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!", "languageCode": "en" }, "authorAttribution": { "displayName": "John Smith", "uri": "https://www.google.com/maps/contrib/11685942231/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo" }, "publishTime": "2023-05-09T07:24:36Z" "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670" }, . . . ] }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12", "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12" } }, { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Indian restaurant offering comfort food including vegetarian and vegan options.", "languageCode": "en-US" }, . . . }
Örnek genel bakış özeti isteği
Bu örnek metin araması, yalnızca Mountain View, CA'daki baharatlı vejetaryen restoranların overview
özetini döndürür:
curl -X POST -d '{ "textQuery": "Spicy Vegetarian Food", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary.overview" \ https://places.googleapis.com/v1/places:searchText
Yanıtta, overview.text
ve overview.languageCode
içeren generativeSummary.overview
alanı bulunur:
{ "places": [ { "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts", "displayName": { "text": "Zareen's", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.", "languageCode": "en-US" } } }, { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.", "languageCode": "en-US" } } }, . . . }
Üretken alan özeti isteme
Alan özetleri, LLM tarafından bir yerin yakınındaki alan için oluşturulan üretken özetlerdir. Alan özetleri, bir yer hakkında karar veren kullanıcılar için önemli olabilir.
Örneğin, yeni bir şehirde otel rezervasyonu yapmak istediğinizde, gereksinimlerinizi karşılayan bir otel bulabilirken otelin çevresindeki bölge hakkında da daha fazla bilgi edinmek istersiniz. Çevredeki alanın haritasını inceleyip haritadaki her yeri incelemek yerine otel için bir alan özeti oluşturabilirsiniz.
Alan özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir.
Alan özetini yanıta dahil etmek için isteğin alan maskesini ekleyin:
areaSummary
(Yer Ayrıntıları)places.areaSummary
(Metin Arama ve Yakında Arama).
Yanıtta bir yer için areaSummary
alanına, Google'ın kaldırabilmesi için uygunsuz içerikleri işaretlemek üzere kullanabileceğiniz flagContentUri
alanı eklenir. Ayrıca dört adede kadar contentBlocks
dizisi içerir.
Her blokun konusu yerin türüne bağlıdır:
electric_vehicle_charging_station
türündeki bir yer olarak tanımlanan elektrikli araç şarj istasyonu için konu blokları şunlardır:"overview"
,"coffee"
,"restaurant"
ve"store"
.Konaklama kategorisi ve belirli
geocode
ilepremise
yer türleri tarafından tanımlanmış bir türe sahip bir yer için konu blokları şunları içerir:"overview"
,"activity"
,"restaurant"
ve"store"
.
Elektrikli araç şarj istasyonunun alan özeti için örnek istek
Bu örnek Yer Ayrıntısı isteği, Mountain View'daki belirli bir elektrikli araç şarj istasyonunun
ChIJC5b6QKiwj4ARgn2EwlnJnWU
yer kimliğiyle tanımlanan alan özetini döndürüyor:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,areaSummary" \ https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU
Yanıtta, contentBlocks
dizisi dahil olmak üzere areaSummary
alanı bulunur:
topic
alanı, içerik bloğunun türünü belirtir. Bu örnekteki yer bir elektrikli araç şarj istasyonu olduğundan dört içerik bloğu"overview"
,"coffee"
,"restaurant"
ve"store"
'tır.content
alanı, dil kodu da dahil olmak üzere ilgili konunun özetini içerir.references
dizisi, içerik bloğuna içerik sağlamak için kullanılan yer kaynağı adlarınıplaces/PLACE_ID
biçiminde belirtir.
{ "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU", "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "areaSummary": { "contentBlocks": [ { "topic": "overview", "content": { "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY", "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ" ] } }, { "topic": "coffee", "content": { "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY" ] } }, { "topic": "restaurant", "content": { "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ", "places/ChIJETHw0F-7j4AR85V_I6OobCI", "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0", "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk" ] } }, { "topic": "store", "content": { "text": "Safeway provides a range of groceries, along with a deli and a bakery.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12" } }
Bir otelin alan özeti için örnek istek
Bu örnek metin arama isteği, Kaliforniya, Mountain View'daki otelleri ister:
curl -X POST -d '{ "textQuery": "Hotels", "location_bias":{ "rectangle":{ "low": { "latitude": 37.415, "longitude": -122.091}, "high":{ "latitude": 37.429, "longitude": -122.065} } }, "maxResultCount": 5 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,places.areaSummary" \ https://places.googleapis.com/v1/places:searchText
Yanıt, contentBlocks
dizisi dahil olmak üzere areaSummary
alanını içerir. Otel türündeki yerler için verilen yanıtta "overview"
, "activity"
, "restaurant"
ve "store"
konularına yönelik içerik blokları bulunur:
{ "places": [ { "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4", "displayName": { "text": "Shashi Hotel Mountain View, an Urban Resort", "languageCode": "en" }, "areaSummary": { "contentBlocks": [ { "topic": "overview", "content": { "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJOYvCo1W3j4AR1LAifgk13rs", "places/ChIJm7NJkla3j4AR8vR-HWRxgOo", "places/ChIJo4za6vi5j4ARMua093RgGGA", "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU" ] } }, { "topic": "activity", "content": { "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJOYvCo1W3j4AR1LAifgk13rs", "places/ChIJm7NJkla3j4AR8vR-HWRxgOo", "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI" ] } }, { "topic": "restaurant", "content": { "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJC_3cdla3j4ARMgf4Pw8Irek", "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo", "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g" ] } }, { "topic": "store", "content": { "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.", "languageCode": "en-US" }, "references": { "places": [ "places/ChIJh64-r0O3j4ARy1P41IH2j3k", "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns" ] } } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12" } }, ... ] }
Bağlama dayalı arama sonuçlarını isteme
Metin Arama (Yeni) isteğinin yanıtı, giriş arama dizesinin ölçütleriyle eşleşen bir yer dizisi içerir. Artık API'ye yapılan giriş sorgusuna göre yanıtta bağlamsal arama verileri isteyebilirsiniz.
Bağlamsal özetleri desteklemek için Metin Arama (Yeni) yanıtı, yanıttaki places
dizisiyle aynı düzeyde olan contextualContents
adlı yeni bir dizi içerir:
{ "places": [], "contextualContents":[] }
contextualContents
dizisindeki ContextualContent
türündeki her öğe, places
dizisindeki yerle aynı dizi konumundadır. Yani contextualContents[0]
öğesi places[0]
konumundaki yere karşılık gelir.
Her dizi öğesi aşağıdaki dizi alanlarını içerir:
contextualContents.reviews
: En fazla üç yorumdan oluşan bir dizi.contextualContents.photos
: En fazla beş fotoğraf içeren bir dizi.contextualContents.justifications
: Aşağıdakiler dahil olmak üzere yer için açıklamalar dizisi:reviewJustification
: Kullanıcı yorumunun son kullanıcının ilgisini çekebilecek bir bölümünü öne çıkarın.businessAvailabilityAttributesJustification
: Bir işletmenin son kullanıcının ilgisini çekebilecek özelliklerini içerir.
Bağlamsal arama sonuçlarını yanıta dahil etmek için Metin Arama (Yeni) isteğinin alan maskesine contextualContents
ekleyin:
curl -X POST -d '{ "textQuery": "Spicy vegetarian restaurant in Mountain View, CA", "openNow": true, "maxResultCount": 3 }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \ https://places.googleapis.com/v1/places:searchText
Yanıt, yanıttaki her yer için contextualContents
dizisini içerir:
{ "places": [ { "id": "ChIJETHw0F-7j4AR85V_I6OobCI", "displayName": { "text": "Hyderabad Dum Biryani", "languageCode": "en" } }, . . . ], "contextualContents": [ { "reviews": [ { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB", "relativePublishTimeDescription": "a year ago", "rating": 5, "text": { "text": "Very tasty! Rich spices and textures. We really appreciated all of the vegan options. We shared samosas (great sauce!) , tofu 65 (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to the tofu 65) and veg pakoras (very crunchy and awesome flavor). We enjoyed all of it, with the pakoras being the table's favorite.", "languageCode": "en" }, "originalText": { "text": "Very tasty! Rich spices and textures. We really appreciated all of the vegan options. We shared samosas (great sauce!) , tofu 65 (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to the tofu 65) and veg pakoras (very crunchy and awesome flavor). We enjoyed all of it, with the pakoras being the table's favorite.", "languageCode": "en" }, "authorAttribution": { "displayName": "Jane Doe", "uri": "https://www.google.com/maps/contrib/113193/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100" }, "publishTime": "2023-04-18T02:48:02Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB", "relativePublishTimeDescription": "10 months ago", "rating": 5, "text": { "text": "This is a nice little spot to eat at. I'm a big fan of curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.", "languageCode": "en" }, "originalText": { "text": "This is a nice little spot to eat at. I'm a big fan of curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.", "languageCode": "en" }, "authorAttribution": { "displayName": "Bob Jones", "uri": "https://www.google.com/maps/contrib/11034435/reviews", "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100" }, "publishTime": "2023-07-03T16:51:49Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db" }, . . . ], "photos": [ { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ", "widthPx": 1920, "heightPx": 1080, "authorAttributions": [ { "displayName": "A Google User", "uri": "//maps.google.com/maps/contrib/113010465422", "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db" }, { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo", "widthPx": 960, "heightPx": 720, "authorAttributions": [ { "displayName": "Toast" } ], "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db" }, . . . ], "justifications": [ { "reviewJustification": { "highlightedText": { "text": "\"Not too spicy or oily.\"", "highlightedTextRanges": [ { "startIndex": 9, "endIndex": 14 } ] }, "review": { "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE", "relativePublishTimeDescription": "10 months ago", "rating": 5, "text": { "text": "Not too spicy or oily. We have the mutton dum biryanis and tandoori fish. Very flavorful. The food was served promptly. Clean environment. A little small more like a hole in the wall. We'd come back for sure.", "languageCode": "en" }, "originalText": { "text": "Not too spicy or oily. We have the mutton dum biryanis and tandoori fish. Very flavorful. The food was served promptly. Clean environment. A little small more like a hole in the wall. We'd come back for sure.", "languageCode": "en" }, "authorAttribution": { "displayName": "Stan Davis", "uri": "https://www.google.com/maps/contrib/112959/reviews", "photoUri": "https://lh3.googleuser-cc-rp-mo" }, "publishTime": "2023-06-18T06:12:41Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1", "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db" } } }, { "businessAvailabilityAttributesJustification": { "dineIn": true } } ] }, . . . ] }
Otomotiv kullanım alanları için uygulama kılavuzu
Google, sürücü güvenliği için otomotiv deneyimlerinde üretken yapay zeka özetlerini park modunda oluşturmayı önerir. Sürüş modunda özetler oluşturuluyorsa sürücünün dikkatinin yola hızlıca dönmesini sağlamak için ekrandaki bilgiler basit, net ve kısa olmalıdır.
- En fazla 3 satır
- En fazla 120 karakter veya 24 kelime
- Minimum ön boyut 24 dp'dir.
Özellikle otomotiv bağlamında, üretken yapay zeka özetlerini güvenli ve tüm yerel yasalara ve yönetmeliklere uygun şekilde oluşturmak geliştiricinin sorumluluğundadır.
İlişkilendirmeler
Uygulamanızda yorumlar, fotoğraflar ve üretken yapay zeka özetlerini (hem yer hem de alan özetleri dahil) gösterirken gerekli ilişkilendirmeleri de gösterdiğinizden emin olmanız gerekir.
Üretken özetler için ilişkilendirmeleri gösterme
Uygulamanızda yer ve bölge özetleri dahil üretken yapay zeka özetleri gösterdiğinizde gerekli atıfları da göstermeniz gerekir. Bu bölümde, uygulamanızda üretken yapay zeka özetlerini nasıl gösterdiğinize bağlı olarak ilişkilendirmelerin nasıl gösterileceği açıklanmaktadır.
İlişkilendirmede her durumda normal cümle düzeni kullanılmalıdır. İlişkilendirme ve Google logosu tüm renk, stil ve yazı tipi standartlarına uygun olmalıdır. Bu standartlar hakkında daha fazla bilgi için Places API (Yeni) Politikaları başlıklı makaleyi inceleyin.
Diğer Google verileri bağlamında gösterilen üretken yapay zeka özeti
Bu durumda, Google'ın içeriği başka bir yerde ilişkilendirmesine bağlı olarak üretken yapay zeka ilişkilendirmesi, özetin üzerinde veya altında tek başına gösterilebilir.
Atıf için bu resimde gösterildiği gibi "Yapay zeka tarafından özetlendi" metnini kullanın:
Üretken yapay zeka özeti tek başına gösteriliyor
Üretken yapay zeka özeti, Google Haritalar'daki diğer içeriklerden ayrı olarak göründüğünde hem üretken yapay zeka ilişkilendirmesini hem de Google ilişkilendirmesini noktalı virgül ile ayırarak içermelidir. Atıf için "Yapay zeka tarafından özetlendi" metnini ve bu resimde gösterilen Google logosunu kullanın:
Bir listede tekrarlanan üretken yapay zeka özeti
Üretken yapay zekayı tekrarlarken, özete genel bakışı bir yer listesine yerleştirirken:
- Liste içeriği Google ile ilişkilendirilir
- Gösterilen özetler yapay zeka tarafından oluşturulur.
- İçerik Google'da mevcuttur
İlişkilendirme, listenin üstünde veya altında tek bir satırda gösterilmelidir. Yapay zeka ilişkilendirmesi solda, Google ilişkilendirmesi ise sağda hizalanır:
Bir listede daha uzun biçimli üretken yapay zeka açıklama özetleri kullanılıyorsa her özetin yapay zeka ilişkilendirmesi ("Yapay zeka tarafından özetlendi" bilgi simgesi/düğmesi) olmalıdır.
Üretken yapay zeka özetiyle ilgili bilgileri iletişim kutusunda görüntüleme
Üretken yapay zeka özetiyle birlikte, son kullanıcıların özet hakkında bilgi görüntüleyebileceği bir iletişim kutusu ve flagContentUri
alanındaki özetin benzersiz tanımlayıcısını kullanarak sorunları bildirmek için bir bağlantı sağlamanız gerekir. Üretken yapay zeka açıklama özeti kullanırken özetin kaynakları hakkında bilgi (referanslar) eklemeniz gerekir.
Yukarıdaki örneklerde gösterildiği gibi, yapay zeka ilişkilendirmesi ile birlikte bir bilgi simgesi (etkileşim olanağı olarak) ekleyip yapay zeka ilişkilendirme alanı ile simgesinin bir basmaya/tıklamaya yanıt vermesini sağlayarak bu iletişim kutusuna erişimi etkinleştirin.
Üretken yer özetleri için şunları gösterin:
Hakkında | Yapay zeka tarafından oluşturulan yer özetleri, Google yorumlarından ve diğer verilerden elde edilir. |
Sorun Bildir | Özetin içeriğiyle ilgili bir sorunu Google'a bildirmek için flagContentUri alanındaki bağlantıyı kullanın. |
Referanslar | Kaynak yorumları |
Örneğin:
Üretken alan özetleri için şunları gösterin:
Hakkında | Yapay zeka tarafından oluşturulan alan özetleri, Google yorumlarından ve yerel verilerden elde edilir. |
Sorun Bildir | Özetin içeriğiyle ilgili bir sorunu Google'a bildirmek için flagContentUri alanındaki bağlantıyı kullanın. |