Genel Bakış
Haritalar Platformu Ajan Tabanlı Kullanıcı Arayüzü Araç Seti, özel olarak etkileşimli yapay zeka dönemi için tasarlanmış bir geliştirici araç setidir. Büyük dil modelleri (LLM'ler) ve yapay zeka ajanlarının coğrafi veriler için anlık, etkileşimli görsel yanıtlar oluşturmasına yardımcı olan bir dizi LLM sistem talimatı ve kullanıcı arayüzü bileşenleri kitaplığı sağlar.
Görsel öğeleri sabit kodlamak yerine, LLM'den gelen "amaca dayalı talimatları" dinamik ve bağlama duyarlı haritalara ve yer gösterimlerine çevirmek için araç kitini kullanabilirsiniz. Böylece kullanıcılar sohbet deneyiminde etkileşimde kalır.
Yaygın kullanım alanları:
- Yapay Zeka Asistanları: Yerel sorgular (ör. oteller, restoranlar) için metin yanıtlarını görsel bağlamla zenginleştirme.
- Seyahat planlayıcılar: Haritaları, rotaları ve yer ayrıntılarını satır içi olarak gösterir.
- Basit kodlama gerektiren geliştirme: Web ve mobil temas noktalarında birden fazla Haritalar API'sinin manuel olarak düzenlenmesiyle ilgili sorunları azaltır.
Temel kavramlar
1. Ajan tabanlı kullanıcı arayüzü
Özellikle gerçek zamanlı LLM destekli deneyimler için tasarlanmış, ölçeklenebilir ve yüksek kaliteli görseller (ör. yer kartları, Immersive View haritaları ve rota önizlemeleri) sunun.
2. Bağlam açısından zengin deneyimler
Kullanıcıların sohbetten ayrılmadan keşif yapmasına ve karar vermesine olanak tanıyın. Fotoğraf galerileri, puanlar veya rota seçenekleri gibi zengin satır içi harita bağlamı sunmak, kullanıcıların ilgisini canlı tutar ve onlara harekete geçme konusunda güven verir.
3. Akıllı bileşenler
Agentic UI araç seti, karmaşık coğrafi uzamsal mantığı otomatik olarak işler. Bağlamı ve düzeni anında kullanıcı niyeti'ne göre uyarlarken her etkileşimin markanızla bağlantılı olmasını sağlamak için stil oluşturur.
4. LLM'den bağımsız
Ajan tabanlı kullanıcı arayüzü araç seti, yapay zeka araç koleksiyonunuzdan bağımsızdır. Gemini'ı veya OpenAI ya da Anthropic'in modellerini kullanıyor olmanız ve temellendirilmiş veri kaynağınızdan bağımsız olarak Agentic UI araç seti, konum verilerini görselleştirmek için özel sunum katmanı sağlar.
5. Sunucu tarafı şablon mimarisi
Sunucu tarafı şablon mimarisi, şablon genişletme ve parametre çözümleme işlemlerini sunucu tarafında gerçekleştirerek bileşen oluşturmayı hızlandırır. Bu, anlık sohbet deneyimlerinde gecikmeyi önemli ölçüde azaltır.
Başlarken
Agentic UI araç setini kullanmaya başlamak için Google Gemini API anahtarı ve Google Haritalar Platformu API anahtarıyla başlatmanız gerekir.
Ayrıntılı talimatlar için Başlangıç Kılavuzu'na bakın.
Kullanıcı arayüzü sonuçları
Ajan tabanlı kullanıcı arayüzü araç seti, kutudan çıktığı haliyle kapsamlı bir özel kullanıcı arayüzü yetenekleri paketi sunar. Bu bileşenler web, Android ve iOS'te kullanılabilir.
- Yer Ayrıntısı (Kompakt): Kompakt bir kartta belirli ÖY bilgileri.
- Satır içi haritalar: Nokta veya alan bulucu.
- Satır İçi Harita + Rota: Navigasyon veya yolculuk önizlemeleri.
- Satır İçi Harita Ayrıntısı: Zengin görüntüler kullanarak konumun atmosferi veya bağlamı.
Sistem talimatları
Agentic UI araç seti, kullanıcı arayüzünün ne zaman ve nasıl oluşturulacağı konusunda ana LLM'ye yol göstermek için "sistem talimatları" sağlar.
Yönergeler
Ana makine modeli şunları anlamalıdır:
Hangi bileşenin hangi kullanıcı niyetine uygun olduğu (ör. yön bulma sorguları için satır içi harita kullanma).
Doğal dilden şemaya parametre eşleme (ör. kullanıcı "manzaralı" bir yer isterse harita modu uydu olarak ayarlanır).
Araç kullanım şeması
Agentic UI araç seti, standart LLM araç kullanımı şemasıyla (ör. işlev çağrısı) uyumlu bir tanım kataloğu sunar.
Politikalar ve Hizmet Şartları
Bu kitaplık, Google Haritalar Platformu hizmetlerini kullanır. Google Haritalar Platformu hizmetlerinin bu kitaplık üzerinden kullanımı, Google Haritalar Platformu Hizmet Şartları'na tabidir. Grounding Lite ve Google Haritalar ile Grounding gibi bazı API'ler ve arka uç hizmetleri için ek Hizmet Şartları koşulları geçerlidir. Bu koşulların da karşılanması gerekir.
Bu kitaplık, Google Haritalar Platformu Temel Hizmeti değildir. Bu nedenle, Google Haritalar Platformu Hizmet Şartları (ör. Teknik Destek Hizmetleri, Hizmet Düzeyi Sözleşmeleri ve Kullanımdan Kaldırma Politikası) bu kitaplıktaki kod için geçerli değildir.
Destek
Bu kitaplık, açık kaynak lisansı ile sunulur. Google Haritalar Platformu Teknik Destek Hizmetleri Yönergeleri, SLA veya Kullanımdan Kaldırma Politikası kapsamına girmez. Ancak kütüphane tarafından kullanılan tüm Google Haritalar Platformu hizmetleri, Google Haritalar Platformu Hizmet Şartları'na tabi olmaya devam eder.
Google Haritalar kaynakları için ilişkilendirme koşulları
Ajan tabanlı kullanıcı arayüzü araç setinden gelen her araç yanıtında kaynaklar yer alır. Araç setinde sağlanan araçları kullanan sonuçları sunarken, ilişkili Google Haritalar kaynaklarını aşağıdaki koşulları karşılayacak şekilde eklemeniz gerekir:
- Google Haritalar kaynakları, kaynakların desteklediği oluşturulmuş içeriği hemen takip etmelidir.
- Google Haritalar kaynakları, tek bir kullanıcı etkileşimi içinde görüntülenebilmelidir.
Geri bildirim paylaşma
Haritalar ajan tabanlı kullanıcı arayüzü araç setiyle ilgili geri bildirim paylaşmak için aşağıdaki formları kullanın: