Google Haritalar Platformu Code Assist Toolkit (deneysel)

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 belgelere 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 ve retrieve-google-maps-platform-docs aracı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'i deneysel aşamadayken kullanmak ücretsizdir.

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 kullanmak istediğiniz 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 sunucu 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'de 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ı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 Maps Code Assist 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ı. Maps Code Assist için 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: