Google Haritalar Platformu Kod Yardımı araç seti, Google Haritalar Platformu ile uygulama geliştirmek için kullanılan büyük dil modellerinden (LLM'ler) gelen yanıtları iyileştiren bir Model Context Protocol (MCP) sunucusudur. Yanıtları resmi ve güncel dokümanlara ve kod örneklerine dayandırır.
MCP sunucusu, modele istem gönderildiğinde içeriğe eriştiğinden LLM'nin Google Haritalar Platformu ile ilgili bağlamı, modelin eğitim tarihindeki mevcut verilerle sınırlı olmak zorunda değildir.
MCP sunucusunun erişebileceği Google Haritalar Platformu kaynakları şunlardır:
- Google Haritalar Platformu Belgeleri
- Google Haritalar Platformu Hizmet Şartları
- Google Haritalar Platformu Güven Merkezi
- Google Haritalar Platformu'nun resmi GitHub kuruluşlarındaki kod depoları
Araçlar
Maps Code Assist, LLM'lerin aşağıdaki özelliklere erişmesine olanak tanıyan araçlar sağlar:
retrieve-instructions: İstemci tarafından, kullanıcı niyetini en iyi şekilde yorumlama veretrieve-google-maps-platform-docsaracına etkili çağrılar oluşturma hakkında önemli sistem talimatları almak için kullanılan yardımcı bir araçtır.retrieve-google-maps-platform-docs: Birincil araç. Doğal dildeki sorguyu alır ve barındırılan bir Veriyle Artırılmış Üretim (RAG) motoruna gönderir. RAG motoru, resmi Google Haritalar Platformu belgelerinin, eğitimlerinin ve kod örneklerinin yeni sürümlerini arar ve doğru bir yanıt oluşturması için LLM'ye alakalı bağlamı döndürür.
Faturalandırma
Maps Code Assist, deneysel aşamadayken ücretsiz olarak kullanılabilir.
Politikalar ve hizmet şartları
Maps Code Assist, bu hizmete ilişkin hizmete özel şartlar da dahil olmak üzere Google Haritalar Platformu Hizmet Şartları'na tabidir. Bu bölümde, uyumlu LLM'ler ve kaynak ilişkilendirme koşulları dahil olmak üzere Maps Code Assist için ek hizmet kullanım şartları açıklanmaktadır.
Uyumlu LLM'ler için koşullar
Maps Code Assist'i yalnızca Google Haritalar Platformu Hizmet Şartları'na uygun bir LLM ile kullanabilirsiniz.
Örneğin, Google Haritalar içeriğinin, kullanmayı seçtiğiniz LLM tarafından önbelleğe alınmamasını, depolanmamasını veya LLM'yi iyileştirmek için kullanılmamasını sağlamak sizin sorumluluğunuzdadır. Maps Code Assist'i kullanmadan önce, Maps Code Assist ile kullanmayı planladığınız tüm modellerin Hizmet Şartları'nı incelemeniz gerekir. Maps Code Assist'i, modele girilen verileri model eğitimi veya iyileştirme için kullanan modellerle kullanmamalısınız. Modeli kullanımınızın, hizmete özel şartlar da dahil olmak üzere Google Haritalar Platformu Hizmet Şartları'ndaki Google Haritalar İçeriği ile ilgili kısıtlamalara tam olarak uymasını sağlamak sizin sorumluluğunuzdadır.
Google Haritalar kaynakları için ilişkilendirme koşulları
Maps Code Assist tarafından sağlanan araçları kullanan sonuçları sunarken ilgili Google Haritalar kaynaklarını eklemeniz gerekir.
LLM'leri, Maps Code Assist MCP sunucusuna erişecek şekilde yapılandırma
İlgili MCP yapılandırma belgelerini inceleyip Code Assist MCP sunucusu uç noktasını (https://mapscodeassist.googleapis.com/mcp) kullanarak LLM'leri MCP sunucusuna erişecek şekilde yapılandırabilirsiniz.
Maps Code Assist MCP sunucusu, Streamable HTTP aktarımını kullanır. Daha fazla bilgi için Yapay zeka uygulamasında MCP'yi yapılandırma başlıklı makaleyi inceleyin.
Örnek kullanım alanları
Yapılandırma tamamlandıktan sonra LLM'nize Google Haritalar Platformu hakkında sorular sorabilirsiniz. Aşağıda bazı istem örnekleri verilmiştir:
- "Android uygulamama nasıl harita ekleyebilirim?"
- "iOS'te kullanıcının mevcut konumunu haritada göstermenin en iyi yolu nedir?"
- "Maps JavaScript API'deki yol tarifi hizmetinin kullanımına bir örnek ver."
Developer Knowledge MCP sunucusuyla eşleme
Developer Knowledge MCP sunucusu, Google Haritalar Platformu, Firebase, Google Cloud ve Android gibi Google geliştirici sitelerindeki resmi belgeleri arayan uzak bir MCP sunucusudur. Bu sayede yapay zeka asistanınız, yanıtlarını güncel belgelere dayandırabilir. Bu araç seti, Maps Code Assist araçlarının yerini almak yerine onları tamamlayan search_documents, get_documents ve answer_query araçlarını sunar. Haritalar
Code Assist, Google Haritalar Platformu için özel olarak tasarlanmıştır. Bu nedenle, projenizde diğer Google ürünleri de kullanılıyorsa ikisini eşleştirmek en faydalı yöntemdir.
Maps Code Assist ile birlikte yapay zeka uygulamanıza eklemek için IDE'nizi veya kodlama temsilcinizi yapılandırma bölümündeki adımları uygulayın ve istemcinizi seçin. Asistanınızın dokümanlarda ne zaman arama yapacağına karar vermesine yardımcı olmak için retrieving-developer-knowledge temsilci becerisini de yükleyin.
Her iki sunucu da yapılandırıldığında, ürünler arası sorular sorabilirsiniz. Örneğin:
- "Places API (New) otomatik tamamlama isteği biçimini ve Cloud Functions for Firebase dokümanlarını inceleyin, ardından kısıtlanmış API anahtarımı kullanarak otomatik tamamlama isteklerini proxy'leyen çağrılabilir bir işlev yazın."
Mevcut araçlar
Maps Code Assist MCP sunucusu için kullanılabilir MCP araçlarının ayrıntılarını ve açıklamalarını görüntülemek üzere Maps Code Assist MCP referansını inceleyin.
HTTP isteğiyle araçları listeleme
Sunucunun çalıştığını doğrulamak ve kullanılabilir araçların listesini görmek için doğrudan Haritalar Kod Yardımı uzak MCP sunucusuna tools/list HTTP isteği gönderebilirsiniz.
tools/list yöntemi, kimlik doğrulama gerektirmez.
curl -X POST https://mapscodeassist.googleapis.com/TOOLSET_ENDPOINT \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
-H 'Mcp-Method: tools/list' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {
"_meta": {
"io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
"io.modelcontextprotocol/clientCapabilities": {
"extensions": {
"io.modelcontextprotocol/ui": {
"mimeTypes": ["text/html;profile=mcp-app"]
}
}
}
}
}
}'
Aşağıdakini değiştirin:
TOOLSET_ENDPOINT: Hizmet adından sonraki MCP uç noktasının geri kalanı. Haritalar için Code Assist'te bu değermcpşeklindedir.MCP_PROTOCOL_VERSION: MCP protokolü sürümü. Örneğin,2026-07-28.
Geri bildiriminizi paylaşın
Maps Code Assist hakkında geri bildirim paylaşmak için aşağıdaki formları kullanın: