Genel Bakış
Haritalar Platformu Ajan tabanlı kullanıcı arayüzü araç seti, özel olarak etkileşimli yapay zeka çağı 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ı şunlardır:
- Yapay zeka asistanları: Otel ve restoran gibi yerel sorgular 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 zorlukları azaltır.
Temel kavramlar
1. Ajan hazır 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ı, etkileyici harita görünümleri ve rota önizlemeleri) oluşturun.
2. Bağlam açısından zengin deneyimler
Kullanıcıların sohbetten ayrılmadan keşif yapmasına ve karar vermesine yardımcı olun. Kullanıcıların ilgisini çekmek ve onlara harekete geçme konusunda güven vermek için zengin satır içi harita bağlamı (ör. fotoğraf galerileri, puanlar veya rota seçenekleri) sağlayın.
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ı amacına 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
Temsilci tabanlı kullanıcı arayüzü araç seti, yapay zeka araç koleksiyonunuzdan bağımsızdır. Gemini'ı, OpenAI veya Anthropic'in modellerini kullanmanızdan ve temellendirilmiş veri kaynağınızdan bağımsız olarak araç seti, konum verilerini görselleştirmek için özel bir 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 azaltır.
Başlayın
Agentic UI araç setini kullanmaya başlamak için Google Gemini API anahtarı ve Google Haritalar Platformu API anahtarıyla başlatmanız gerekir.
Daha fazla bilgi için Başlangıç başlıklı makaleyi inceleyin.
Kullanıcı arayüzü sonuçları
Ajan tabanlı kullanıcı arayüzü araç seti, kutudan çıkarıldığında kapsamlı bir özel kullanıcı arayüzü yetenekleri paketi sunar. Bu bileşenler web'de, Android'de ve iOS'te kullanılabilir.
- Yer ayrıntısı, kompakt: Kompakt bir kartta belirli bir önemli yer (ÖY) bilgisi
- Satır içi haritalar: Nokta veya alan bulucu
- Satır içi harita ve rota: Navigasyon veya yolculuk önizlemeleri
- Satır İçi Harita Ayrıntısı: Zengin görüntüler kullanılarak konum ayrıntıları veya bağlam
Sistem talimatları
Agentic UI araç seti, ana LLM'ye kullanıcı arayüzünün ne zaman ve nasıl oluşturulacağı konusunda yol göstermek için "sistem talimatları" sağlar.
Yönergeler
Ana makine modeli aşağıdaki kavramları anlamalıdır:
- Bileşenleri kullanıcı niyetine göre eşleme (ör. yön bulma sorguları için satır içi harita kullanma)
- Parametrelerin doğal dilden şemaya nasıl eşleneceği (ör. kullanıcı "manzaralı" istediğinde harita modunu uydu olarak ayarlama)
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, ek Hizmet Şartları koşullarına tabidir. 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ı aracılığıyla 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ç setindeki her araç yanıtında kaynaklar yer alır. Araç setinin sağladığı araçları kullanan sonuçları sunarken, ilişkili Google Haritalar kaynaklarını aşağıdaki şartları 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 bildiriminizi paylaşın
Haritalar ajan tabanlı kullanıcı arayüzü araç setiyle ilgili geri bildirimlerinizi paylaşmak için aşağıdaki formları kullanın: