Alat agen Maps Experience

Alat agen Maps Experience (sebelumnya Maps Grounding Lite) adalah layanan Google Maps Platform dengan dukungan Model Context Protocol (MCP) dan REST untuk melakukan grounding pada aplikasi AI Anda dengan data geospasial tepercaya dari Google Maps. Alatnya memungkinkan LLM mengakses data tempat, cuaca, kualitas udara, serbuk sari, dan rute. Alat lain me-resolve nama lokasi dan URL Google Maps ke ID tempat. Anda dapat mencoba alat agen Maps Experience dengan mengaktifkan server MCP-nya di alat apa pun yang mendukung server MCP. Anda juga dapat memanggil setiap alat sebagai metode REST. Untuk mengetahui detailnya, lihat Memanggil alat dengan REST.

Alat agentic Maps Experience adalah satu produk dengan dua SKU: Essentials dan Pro. Setiap permintaan ditagih dalam paket Essentials, kecuali jika menggunakan opsi Pro. Opsi Pro menambahkan penelusuran tempat di sepanjang rute, detail tempat yang diperluas, lebih banyak tempat per penelusuran, lebih banyak perhentian per rute, pemilihan rute dengan lalu lintas real-time, perkiraan serbuk sari, dan kualitas udara historis. Kedua SKU menggunakan alat, server MCP, metode REST, dan kredensial yang sama. Untuk mengetahui detailnya, lihat Essentials dan Pro.

Alat

Alat agentic Maps Experience memungkinkan LLM mengakses kemampuan Google Maps berikut:

• Menelusuri tempat: Minta informasi tentang tempat dan dapatkan ringkasan buatan AI. Respons juga menyertakan ID tempat, koordinat lintang/bujur, dan link Google Maps untuk setiap tempat dalam ringkasan. Anda dapat menggunakan ID tempat dan koordinat lintang/bujur dengan Google Maps Platform API lainnya untuk menampilkan tempat di peta. Untuk menampilkan tempat ini dengan Places UI Kit tanpa biaya tambahan, gunakan token visualisasi data agentic (Pratinjau). Dengan Pro, Anda dapat meminta detail tempat yang diperluas, seperti insight dari ulasan, dan hingga 10 tempat per permintaan.
• Telusuri di sepanjang rute: Temukan tempat di sepanjang rute perjalanan—yang ditentukan menggunakan retrieval_token dari compute_routes, route_endpoints, atau encoded_polyline—dan dapatkan ringkasan yang dihasilkan AI, detail tempat, jarak memutar dan waktu perjalanan, serta token visualisasi data agentic (Pratinjau). Setiap permintaan search_along_route ditagih berdasarkan SKU Pro.
• Mencari informasi cuaca: Minta kondisi lingkungan untuk suatu lokasi, termasuk cuaca (kondisi saat ini, histori per jam selama 24 jam, dan perkiraan per jam dan harian hingga 10 hari) dan kualitas udara saat ini atau perkiraan hingga 4 hari. Dengan Pro, Anda juga dapat meminta perkiraan serbuk sari harian hingga 5 hari (dengan detail spesies tanaman) dan histori kualitas udara per jam hingga 30 hari.

• Compute routes: Meminta rute antara tempat asal dan tujuan, secara opsional melalui pemberhentian sementara, dan menampilkan jarak, durasi, dan retrievalToken rute untuk rute DRIVE yang dapat Anda teruskan ke search_along_route. Dengan Pro, rute dapat memperhitungkan kondisi lalu lintas real-time dan menyertakan lebih banyak perhentian sementara.

• Selesaikan nama dan Selesaikan URL Maps: Selesaikan nama lokasi, alamat, dan URL Google Maps ke ID tempat. Untuk mengetahui informasi selengkapnya, lihat Resolution API.

Setelah Anda mengaktifkan server MCP, LLM dapat memanggil alatnya untuk mendapatkan informasi grounding untuk jenis data ini. LLM dapat menggunakan informasi ini untuk konteks. Namun, respons akhirnya mungkin tidak menyertakan informasi persis yang ditampilkan oleh server MCP. Verifikasi akurasi respons yang dihasilkan.

Essentials dan Pro

Essentials dan Pro adalah dua SKU dari produk yang sama, bukan produk atau paket terpisah. Permintaan akan ditagih berdasarkan Pro jika menggunakan opsi Pro. Setiap permintaan lainnya akan ditagih berdasarkan Essentials. Opsi Pro adalah kolom biasa dalam permintaan alat, sehingga LLM dapat menggunakannya atas nama Anda. Agen juga dapat menggunakan kedua SKU dalam percakapan yang sama. Misalnya, agen mungkin menggunakan Essentials untuk menemukan kedai kopi di dekat tempat terkenal. Kemudian, model ini mungkin menggunakan Pro untuk menjawab pertanyaan lanjutan tentang minuman khas dan tempat duduk mereka. Tidak ada server, endpoint, atau kredensial MCP terpisah untuk Pro.

Membandingkan Essentials, Pro, dan Grounding with Google Maps

Grounding with Google Maps adalah produk terpisah. Fitur ini disertakan dalam model Gemini di Gemini API, Google AI Studio, dan Gemini Enterprise Agent Platform. Model akan memutuskan kapan harus mengkueri Google Maps dan menampilkan jawaban yang di-grounding dengan kutipan. Pilih Grounding with Google Maps saat Anda membangun di Gemini dan ingin model menangani grounding. Pilih alat agentic Maps Experience untuk model atau framework agen lainnya, atau untuk kontrol langsung atas setiap panggilan alat.

Tabel berikut membandingkan SKU Essentials, SKU Pro, dan Grounding dengan Google Maps:

Opsi ini berfungsi sama dengan kedua SKU: mode perjalanan, waktu keberangkatan dan kedatangan, rute alternatif, polyline rute, pencarian cuaca, pencarian kualitas udara saat ini dan prakiraan (termasuk konsentrasi polutan dan skala AQI lokal), sistem unit cuaca, dan Resolution API. Label ini tidak mengubah SKU yang ditagih untuk permintaan.

Yang ditagih dalam SKU Pro

Tabel berikut merangkum kemampuan yang disertakan dalam Essentials dan kemampuan yang memerlukan SKU Pro:

Untuk opsi permintaan yang mengaktifkan setiap kemampuan, lihat Menelusuri tempat, Menelusuri di sepanjang rute, Menghitung rute, dan Mencari cuaca.

Mengontrol penggunaan Pro

Opsi Pro dinonaktifkan secara default di search_places, compute_routes, dan lookup_weather. LLM akan menetapkannya—atau memanggil search_along_route—saat permintaan pengguna memerlukannya dan deskripsi alat atau petunjuk Anda mengizinkannya. Deskripsi alat memberi tahu model opsi mana yang lebih mahal dan kapan harus menggunakannya: page_size di atas 5, detail tempat yang diperluas, lebih dari 10 titik jalan perantara, pemilihan rute berbasis lalu lintas, dan search_along_route. Jika Anda memanggil alat dengan REST, kode Anda akan menetapkan setiap opsi. Untuk mengelola biaya:

• Beri tahu model kapan opsi Pro sesuai. Misalnya: "Tetapkan include_extended_details hanya jika pengguna bertanya tentang ulasan, menu, atau suasana." Atau: "Gunakan ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL hanya saat pengguna meminta waktu perjalanan saat ini." Atau: "Panggil search_along_route hanya saat pengguna meminta tempat di sepanjang rute." Atau: "Sertakan POLLEN, atau AIR_QUALITY dengan date atau hour sebelumnya, hanya jika pengguna bertanya tentang serbuk sari, alergi, atau kualitas udara historis."
• Agar agen tetap menggunakan SKU Essentials, instruksikan model untuk tidak pernah memanggil search_along_route atau menggunakan opsi Pro. Opsi Pro adalah include_extended_details, page_size di atas 5, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, lebih dari 10 titik jalan perantara, POLLEN di capabilities, dan date atau hour sebelumnya dengan AIR_QUALITY di capabilities. Jika klien MCP Anda dapat membatasi alat atau argumen alat, Anda juga dapat memblokir search_along_route dan nilai argumen tersebut dalam konfigurasi alatnya.
• Pantau SKU Maps Grounding Pro di laporan penagihan dan tetapkan pemberitahuan anggaran.

Resolution API

Alat agen Maps Experience menyediakan Resolution API. API ini me-resolve teks lokasi dan URL bentuk bebas menjadi ID tempat Google Maps yang terstruktur. Resolution API tersedia sebagai metode REST dan sebagai alat di server MCP:

• Menyelesaikan nama (REST, MCP): Menyelesaikan batch nama atau alamat lokasi ke entity tempat tertentu di Google Maps. Alat ini membantu mendasarkan kueri pengguna yang tidak terstruktur ke ID tempat yang stabil.
• Menyelesaikan URL Maps (REST, MCP): Menyelesaikan sekumpulan URL Google Maps ke entity tempat tertentu. Format yang didukung mencakup URL tempat standar dan URL yang dipersingkat.

Anda dapat menggunakan ID tempat yang ditampilkan dengan Google Maps Platform API lainnya. Setiap respons juga menyertakan link yang menyimpan tempat yang di-resolve sebagai daftar di Google Maps.

Untuk mengetahui informasi selengkapnya, lihat Maps Tools Resolution API.

Coba aplikasi contoh (Buka di tab baru)

Penagihan dan kuota

Cara Anda ditagih

Dengan model harga bayar sesuai penggunaan Google Maps Platform, penggunaan alat agen Maps Experience dihitung untuk setiap permintaan. Setiap permintaan mewakili satu peristiwa penagihan. Penggunaan dilacak untuk setiap SKU produk. Tagihan Anda menampilkan item baris untuk setiap SKU selain total tagihan Anda. Lihat Ringkasan pelaporan untuk mengetahui informasi selengkapnya.

Setiap permintaan Telusuri tempat, Telusuri di sepanjang rute, Hitung rute, atau Cari info cuaca, melalui server MCP atau dengan REST, ditagih dalam satu SKU: Maps Grounding Essentials atau Maps Grounding Pro. Setiap permintaan search_along_route dan permintaan apa pun yang menggunakan opsi Pro akan ditagih berdasarkan SKU Pro. Permintaan tidak pernah ditagih berdasarkan kedua SKU, dan jumlah opsi Pro dalam permintaan tidak mengubah tagihan. Untuk kemampuan dan opsi yang menentukan SKU untuk setiap alat, lihat Apa yang ditagih dalam SKU Pro.

Permintaan Maps Grounding Essentials ditagih sebesar $7,00 per 1.000 permintaan setelah 10.000 permintaan pertama setiap bulan. Permintaan Maps Grounding Pro ditagih sebesar $14,00 per 1.000 permintaan setelah 5.000 permintaan pertama setiap bulan. Kedua SKU memiliki diskon volume pada penggunaan bulanan yang lebih tinggi.

Lihat Tabel harga utama dan Tabel harga India untuk mengetahui detail harga.

Permintaan Resolution API (ResolveNames dan ResolveMapsUrls) ditagih tanpa biaya berdasarkan SKU Places API Text Search Essentials (IDs Only).

Jika Anda menampilkan tempat dari respons search_places atau search_along_route dengan Places UI Kit, Anda dapat menggunakan token visualisasi data agentic (Pratinjau) agar permintaan Places UI Kit tersebut tidak ditagih.

Penggunaan SKU Essentials disertakan dalam paket Berlangganan untuk berhemat Essentials dan Pro. Penggunaan SKU Pro disertakan dalam paket Pro.

Kuota

Kuota berikut berlaku untuk alat dan API yang disediakan oleh alat agentic Maps Experience:

• Search places: 300 kueri per menit untuk setiap project.
• Penelusuran di sepanjang rute: 300 kueri per menit untuk setiap project.
• Mencari cuaca: 300 kueri per menit untuk setiap project.
• Compute routes: 300 kueri per menit untuk setiap project.
• Menyelesaikan nama: 600 kueri per menit untuk setiap project.
• Resolve Maps URLs: 600 kueri per menit untuk setiap project.

Kuota dihitung untuk setiap alat dan digunakan bersama oleh SKU Essentials dan Pro. Permintaan Pro menggunakan kuota yang sama dengan permintaan Essentials untuk alat yang sama.

Setiap permintaan Resolution API dihitung sebagai satu kueri, terlepas dari jumlah item yang dimuatnya.

Kebijakan dan persyaratan layanan

Alat agen Maps Experience tunduk pada Persyaratan Layanan Google Maps Platform, termasuk persyaratan khusus layanan. Bagian ini menjelaskan persyaratan penggunaan tambahan untuk alat agen Maps Experience, termasuk LLM yang kompatibel dan atribusi sumber. Persyaratan ini berlaku untuk semua hasil, apa pun SKU yang ditagih untuk permintaan.

Persyaratan untuk LLM yang Kompatibel

Anda hanya boleh menggunakan alat agen Maps Experience dengan LLM yang mematuhi Persyaratan Layanan Google Maps Platform.

Misalnya, Anda bertanggung jawab untuk memastikan bahwa Konten Google Maps tidak di-cache, disimpan, atau digunakan untuk meningkatkan kualitas LLM yang Anda pilih untuk digunakan. Sebelum menggunakan alat agen Maps Experience, Anda harus meninjau Persyaratan Layanan untuk model apa pun yang ingin Anda gunakan dengan alat agen Maps Experience. Anda tidak boleh menggunakan alat agen Maps Experience dengan model apa pun yang menggunakan input data ke dalam model untuk pelatihan atau peningkatan model apa pun. Anda bertanggung jawab untuk memastikan bahwa penggunaan model oleh Anda sepenuhnya mematuhi batasan terkait Konten Google Maps dalam Persyaratan Layanan Google Maps Platform, termasuk persyaratan khusus layanan.

Persyaratan atribusi untuk sumber Google Maps

Setiap respons alat dari alat agentic Maps Experience menyertakan sumber. Saat Anda menampilkan hasil dari alat agentic Maps Experience, Anda harus menyertakan sumber Google Maps terkait dan memenuhi persyaratan berikut:

• Sumber Google Maps harus segera mengikuti konten yang dihasilkan yang didukung oleh sumber tersebut. Konten yang dihasilkan ini juga disebut sebagai Output Grounding.
• Sumber Google Maps harus dapat dilihat dalam satu interaksi pengguna.

Sumber untuk alat Telusuri tempat dan Telusuri di sepanjang rute

Kolom places alat search_places dan kolom results[].place alat search_along_route menyediakan sumber yang mendukung summary. Untuk setiap tempat, metadata berikut akan ditampilkan:

• place (nama resource)
• id
• location
• googleMapsLinks
• attribution

Untuk setiap tempat, Anda harus membuat pratinjau link yang memenuhi persyaratan berikut:

• Atribusikan setiap sumber ke Google Maps, dengan mengikuti panduan atribusi teks alat agentic Maps Experience.
• Tautkan ke sumber menggunakan googleMapsLinks.placeUrl dari respons.

Persyaratan ini juga berlaku untuk ringkasan yang menyertakan detail tempat yang diperluas dari Pro, seperti insight dari ulasan. summary mengutip setiap tempat dengan indeks berbasis nol, seperti [0], yang dipetakan ke entri di places atau results. Setiap tempat juga menyertakan googleMapsLinks.reviewsUrl, yang tertaut ke ulasan tempat tersebut di Google Maps. Pengguna dapat mengikutinya untuk melihat ulasan di balik insight.

Antarmuka yang mengutamakan suara

Jika aplikasi Anda menampilkan hasil alat agentic Maps Experience melalui suara, Anda juga harus memenuhi persyaratan untuk antarmuka yang mengutamakan suara. Rangkuman:

• Sumber: Menampilkan sumber Google Maps di UI pendamping yang menampilkan rekaman historis verbatim dari percakapan suara.
• Pengungkapan aktif: Pada saat interaksi, beri tahu pengguna bahwa konten buatan AI mungkin menyertakan informasi dari Google Maps. Beri tahu juga bahwa sumber mendetail tersedia di UI pendamping. Anda dapat melakukannya di layar atau dengan suara.
• Pengungkapan persisten: Simpan penjelasan persisten, misalnya di menu setelan suara, bahwa konten buatan AI dapat menyertakan konten Google Maps.
• Pertanyaan pengguna: Jawab pertanyaan pengguna secara akurat tentang sumber konten, dan arahkan mereka ke UI pendamping untuk mengetahui detailnya.

Mengonfigurasi LLM untuk menggunakan server MCP

Untuk menggunakan alat agentic Maps Experience, Anda memerlukan project Google Cloud dengan layanan API alat agentic Maps Experience diaktifkan. Anda juga memerlukan kunci API atau client ID OAuth. Kemudian, Anda dapat mengonfigurasi LLM untuk mengakses server MCP. Server MCP menggunakan transpor Streamable HTTP.

Mengaktifkan alat agentic Maps Experience di project Google Cloud Anda

Untuk mengaktifkan API di project Anda:

1. Di Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk alat agen Maps Experience.
2. Aktifkan penagihan untuk project di Konsol Google Cloud.
3. Aktifkan alat agentic Maps Experience di Library API Konsol Google Cloud.

Melakukan autentikasi menggunakan kunci API

Anda dapat menggunakan kunci API yang ada dengan alat agentic Maps Experience atau membuat kunci API baru. Apa pun caranya, aktifkan layanan API Maps Experience agent tools di project Google Cloud dan kunci.

Untuk melakukan autentikasi menggunakan kunci API:

1. Buat atau konfigurasikan kunci API dengan mengikuti langkah-langkah di Memulai Google Maps Platform.
2. Teruskan kunci ke server MCP menggunakan header X-Goog-Api-Key. Anda harus menentukannya sebagai header HTTP kustom dalam konfigurasi alat MCP LLM.

Melakukan autentikasi menggunakan OAuth

Anda dapat melakukan autentikasi menggunakan OAuth dengan membuat kredensial OAuth dan meneruskannya ke aplikasi host MCP atau server MCP.

Untuk melakukan autentikasi menggunakan OAuth:

1. Di Konsol Google Cloud, pilih project yang ingin Anda gunakan untuk alat agen Maps Experience.
2. Di menu API & Services, pilih Credentials.
3. Di menu atas, pilih Create credentials > OAuth client ID.
4. Jika project tidak memiliki layar izin yang dikonfigurasi, klik Configure consent screen dan ikuti petunjuk di layar.
5. Di bagian Metrik, klik Buat klien OAuth.
6. Di layar Create OAuth client ID, pilih jenis aplikasi dan masukkan nama untuk client ID.
7. Tentukan detail tambahan yang relevan dengan jenis permohonan Anda. Misalnya, jika Anda membuat aplikasi web, tambahkan URI yang diizinkan untuk permintaan browser dan server.
8. Setelah klien Anda dibuat, simpan client ID dan rahasia klien.
9. Saat Anda mengonfigurasi aplikasi host MCP atau server MCP, teruskan client ID dan rahasia OAuth Anda. Anda juga harus meminta cakupan berikut: https://www.googleapis.com/auth/maps-platform.mapstools.

Untuk mengetahui informasi selengkapnya, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Mengonfigurasi LLM untuk mengakses server MCP alat agentic Maps Experience

Setelah mengaktifkan layanan Maps Experience agent tools dan membuat kredensial, Anda dapat mengonfigurasi LLM untuk mengakses server MCP. Ikuti dokumentasi konfigurasi MCP LLM Anda dan gunakan URL server MCP: https://mapstools.googleapis.com/mcp

Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi MCP di aplikasi AI.

Mengonfigurasi alat agen Maps Experience dengan Gemini CLI

Bagian ini memberikan contoh cara mengonfigurasi server MCP alat agen Maps Experience menggunakan Gemini CLI. Untuk mengetahui detail selengkapnya, lihat Server MCP dengan Gemini CLI.

1. Setelah menginstal Gemini CLI, jalankan gemini mcp add untuk mengonfigurasi server MCP:

   gemini mcp add -s user -t http -H 'X-Goog-Api-Key: API_KEY' maps-experience-agent-tools-mcp https://mapstools.googleapis.com/mcp
   

   Jika konfigurasi berhasil, Anda akan melihat konfirmasi bahwa server telah ditambahkan ke setelan pengguna Anda.

2. Untuk memvalidasi bahwa server berfungsi, jalankan perintah /mcp list:

   > /mcp list
   
   Configured MCP servers:
   
   maps-experience-agent-tools-mcp - Ready (6 tools)
   Tools:
   -   compute_routes
   -   lookup_weather
   -   resolve_maps_urls
   -   resolve_names
   -   search_along_route
   -   search_places
   

3. Mulai ajukan pertanyaan terkait Maps dengan CLI. Misalnya, coba "Rekomendasikan beberapa restoran di Mountain View", yang akan memanggil alat search_places atas nama Anda.

Mengonfigurasi alat agentic Maps Experience dengan Agent Development Kit (ADK)

Bagian ini menunjukkan cara mengonfigurasi server MCP dengan Agent Development Kit (ADK) di Python, Java, atau TypeScript.

# ./adk_agent_samples/mcp_agent/agent.py
import os
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

# Retrieve the API key from an environment variable or directly insert it.
GOOGLE_MAPS_API_KEY = os.getenv("GOOGLE_MAPS_API_KEY")
if not GOOGLE_MAPS_API_KEY:
    GOOGLE_MAPS_API_KEY = "YOUR_GOOGLE_MAPS_API_KEY_HERE"

if GOOGLE_MAPS_API_KEY == "YOUR_GOOGLE_MAPS_API_KEY_HERE":
    print("WARNING: GOOGLE_MAPS_API_KEY is not set.")

root_agent = Agent(
    model='gemini-flash-latest',
    name='travel_planner_agent',
    description='A helpful assistant for planning travel routes.',
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mapstools.googleapis.com/mcp",
                headers={
                    "X-Goog-Api-Key": GOOGLE_MAPS_API_KEY,
                    "Content-Type": "application/json",
                    "Accept": "application/json, text/event-stream"
                }
            )
        )
    ]
)
    

from . import agent
    

package agents;

import com.google.adk.agents.LlmAgent;
import com.google.adk.runner.InMemoryRunner;
import com.google.adk.sessions.SessionKey;
import com.google.adk.tools.mcp.McpToolset;
import com.google.adk.tools.mcp.StreamableHttpServerParameters;
import com.google.genai.types.Content;
import com.google.genai.types.Part;
import java.util.HashMap;
import java.util.Map;

public class MapsAgentCreator {
    public static void main(String[] args) {
        String googleMapsApiKey = System.getenv("GOOGLE_MAPS_API_KEY");
        if (googleMapsApiKey == null || googleMapsApiKey.trim().isEmpty()) {
            googleMapsApiKey = "YOUR_GOOGLE_MAPS_API_KEY_HERE";
            if ("YOUR_GOOGLE_MAPS_API_KEY_HERE".equals(googleMapsApiKey)) {
                System.out.println("WARNING: GOOGLE_MAPS_API_KEY is not set.");
            }
        }

        Map<String, String> headers = new HashMap<>();
        headers.put("X-Goog-Api-Key", googleMapsApiKey);
        headers.put("Content-Type", "application/json");
        headers.put("Accept", "application/json, text/event-stream");

        StreamableHttpServerParameters serverParams =
                StreamableHttpServerParameters.builder("https://mapstools.googleapis.com/mcp")
                        .headers(headers)
                        .build();

        try (McpToolset toolset = new McpToolset(serverParams)) {
            LlmAgent agent = LlmAgent.builder()
                    .model("gemini-flash-latest")
                    .name("travel_planner_agent")
                    .description("A helpful assistant for planning travel routes.")
                    .tools(toolset)
                    .build();

            System.out.println("Agent created: " + agent.name());

            InMemoryRunner runner = new InMemoryRunner(agent);
            String userId = "maps-user-" + System.currentTimeMillis();
            String sessionId = "maps-session-" + System.currentTimeMillis();
            String promptText =
                    "Please give me directions to the nearest pharmacy to Madison Square Garden.";

            SessionKey sessionKey = runner.sessionService()
                    .createSession(runner.appName(), userId, null, sessionId)
                    .blockingGet()
                    .sessionKey();
            System.out.println("Session created: " + sessionId + " for user: " + userId);

            Content promptContent = Content.fromParts(Part.fromText(promptText));
            System.out.println("\nSending prompt: \"" + promptText + "\" to agent...\n");

            runner.runAsync(sessionKey, promptContent)
                    .blockingForEach(event -> {
                        System.out.println("Event received: " + event.toJson());
                    });
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
            e.printStackTrace();
        }
    }
}
    

import 'dotenv/config';
import {LlmAgent, MCPToolset} from "@google/adk";

const googleMapsApiKey = process.env.GOOGLE_MAPS_API_KEY;
if (!googleMapsApiKey) {
    console.warn("WARNING: GOOGLE_MAPS_API_KEY is not set.");
    throw new Error(
        'GOOGLE_MAPS_API_KEY is not provided, please run "export GOOGLE_MAPS_API_KEY=YOUR_ACTUAL_KEY" to add that.'
    );
}

export const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "travel_planner_agent",
    description: "A helpful assistant for planning travel.",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mapstools.googleapis.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        "X-Goog-Api-Key": googleMapsApiKey,
                        "Content-Type": "application/json",
                        "Accept": "application/json, text/event-stream"
                    }
                }
            }
        })
    ],
});
    

Memanggil alat dengan REST

Setiap alat di alat agentic Maps Experience juga tersedia sebagai metode REST. Panggil metode REST secara langsung saat Anda ingin menghubungkan alat ke agen atau aplikasi Anda sendiri—misalnya, untuk mendeklarasikan fungsi Anda sendiri untuk model, memilih opsi yang dapat ditetapkan model, atau menetapkan nilai default dalam kode Anda.

Tabel berikut mencantumkan metode REST untuk setiap alat:

Permintaan REST menggunakan opsi yang sama dengan alat yang sesuai dan menampilkan respons yang sama. Dalam isi permintaan dan respons REST, nama kolom menggunakan lower camel case—misalnya, textQuery, bukan text_query. Permintaan REST ditagih dengan SKU yang sama, mengikuti aturan yang sama untuk opsi Pro, dan dihitung dalam kuota yang sama dengan panggilan alat MCP.

Untuk melakukan autentikasi, gunakan project dan kredensial Google Cloud yang sama dengan yang digunakan untuk server MCP. Untuk mengetahui langkah-langkah penyiapan, lihat Mengonfigurasi LLM untuk menggunakan server MCP. Teruskan kunci API di header X-Goog-Api-Key, atau teruskan token akses OAuth dengan cakupan https://www.googleapis.com/auth/maps-platform.mapstools di header Authorization.

Contoh berikut memanggil metode searchText:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "textQuery": "coffee shops near Golden Gate Park"
}' \
"https://mapstools.googleapis.com/v1:searchText"

Ganti API_KEY dengan kunci API Anda.

Respons berisi kolom summary, places, dan contentToken yang sama dengan hasil alat search_places. Panduan setiap alat menampilkan versi REST dari contohnya.

Membagikan masukan

Untuk memberikan masukan tentang alat agentic Maps Experience, gunakan formulir berikut:

• Laporkan bug
• Mengirim permintaan fitur
• Berikan masukan