Google Haritalar Platformu Code Assist Toolkit (deneysel)

Google Haritalar Platformu Code Assist araç seti, Google Haritalar Platformu ile uygulama geliştirmek için kullanılan büyük dil modellerinden (LLM) gelen yanıtları iyileştiren bir Model Bağlam Protokolü (MCP) sunucusudur. Yanıtları resmi ve güncel dokümanlara ve kod örneklerine dayandırarak çalışı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: İstemcinin, kullanıcı niyetini en iyi şekilde yorumlama ve retrieve-google-maps-platform-docs aracına etkili çağrılar oluşturma konusunda önemli sistem talimatları almak için kullandığı yardımcı araç.
  • retrieve-google-maps-platform-docs: Birincil araç. Doğal dildeki sorguyu 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 koşulları 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. Haritalar Kod Yardımı'nı, 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, akışlı HTTP aktarımı 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 dair bir örnek ver."

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ı'na bakın.

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 bir 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 sonra MCP uç noktasının geri kalanı. Haritalar için Code Assist'te bu değer mcp ş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: