MCP Tools Reference: mapstools.googleapis.com

Alat: lookup_weather

Mengambil data cuaca yang komprehensif, termasuk kondisi saat ini, prakiraan per jam, dan harian.

Data Spesifik yang Tersedia: Suhu (Saat Ini, Terasa Seperti, Maks/Min, Indeks Panas), Angin (Kecepatan, Embusan, Arah), Peristiwa Langit (Matahari Terbit/Terbenam, Fase Bulan), Presipitasi (Jenis, Probabilitas, Kuantitas/QPF), Kondisi Atmosfer (Indeks UV, Kelembapan, Tutupan Awan, Probabilitas Badai Petir), dan Alamat Lokasi yang Di-geocoding.

Lokasi & Aturan Lokasi (PENTING):

Lokasi yang data cuacanya diminta ditentukan menggunakan kolom location. Kolom ini adalah struktur 'oneof', yang berarti Anda HARUS memberikan nilai untuk HANYA SATU dari tiga subkolom lokasi di bawah untuk memastikan pencarian data cuaca yang akurat.

  1. Koordinat Geografis (lat_lng)

    • Gunakan jika Anda diberi koordinat lintang/bujur yang tepat.
    • Contoh: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. ID Tempat (place_id)

    • ID string yang jelas (ID Tempat Google Maps).
    • place_id dapat diambil dari alat search_places.
    • Contoh: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Menara Eiffel

  3. String Alamat (address)

    • String bentuk bebas yang memerlukan spesifikasi untuk geocoding.
    • Kota & Wilayah: Selalu sertakan wilayah/negara (misalnya, "London, UK", bukan "London").
    • Alamat: Berikan alamat lengkap (misalnya, "1600 Pennsylvania Ave NW, Washington, DC").
    • Kode Pos: HARUS disertai dengan nama negara (misalnya, "90210, USA", BUKAN "90210").
    • Contoh: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Mode Penggunaan:

  • Cuaca Saat Ini: Hanya berikan location. Jangan tentukan date dan hour.

  • Prakiraan Per Jam: Berikan location, date, dan hour (0-23). Gunakan untuk waktu tertentu (misalnya, "pukul 17.00") atau istilah seperti "beberapa jam ke depan" atau "nanti hari ini". Jika pengguna menentukan menit, bulatkan ke bawah ke jam terdekat. Prakiraan per jam setelah 120 jam dari sekarang tidak didukung. Cuaca per jam historis didukung hingga 24 jam yang lalu.

  • Prakiraan Harian: Memberikan location dan date. Jangan tentukan hour. Gunakan untuk permintaan hari umum (misalnya, "cuaca besok", "cuaca pada hari Jumat", "cuaca pada 25/12"). Jika tanggal hari ini tidak ada dalam konteks, Anda harus mengklarifikasinya kepada pengguna. Perkiraan harian setelah 10 hari termasuk hari ini tidak didukung. Cuaca historis tidak didukung.

Batasan Parameter:

  • Zona waktu: Semua input date dan hour harus relatif terhadap zona waktu lokal lokasi, bukan zona waktu pengguna.
  • Format Tanggal: Input harus dipisahkan menjadi {year, month, day} bilangan bulat.
  • Units: Defaultnya adalah METRIC. Setel units_system ke IMPERIAL untuk Fahrenheit/Mil jika pengguna menyiratkan standar AS atau memintanya secara eksplisit.

  • Output yang di-grounding harus diatribusikan ke sumber menggunakan informasi dari kolom attribution jika tersedia.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP lookup_weather.

Permintaan Curl 
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Permintaan untuk metode LookupWeather - mewakili kondisi cuaca di lokasi yang diminta.

LookupWeatherRequest

Representasi JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.
}
Kolom
unitsSystem

enum (UnitsSystem)

Opsional. Sistem unit yang akan digunakan untuk kondisi cuaca yang ditampilkan. Jika tidak diberikan, kondisi cuaca yang ditampilkan akan menggunakan sistem metrik (default = METRIC).
location

object (Location)

Wajib. Lokasi untuk mendapatkan kondisi cuaca.

Kolom union _date.

_date hanya dapat berupa salah satu dari hal berikut:
date

object (Date)

Opsional. Tanggal informasi cuaca yang diperlukan. Catatan: Tanggal ini sesuai dengan zona waktu lokal lokasi yang ditentukan di kolom lokasi. Tanggal harus antara 24 jam yang lalu dan 10 hari ke depan.

Kolom union _hour.

_hour hanya dapat berupa salah satu dari hal berikut:
hour

integer

Opsional. Jam informasi cuaca yang diminta, dalam format 24 jam (0-23). Nilai ini relatif terhadap zona waktu lokal dari lokasi yang ditentukan di kolom lokasi. Prakiraan per jam setelah 120 jam dari sekarang tidak didukung. Cuaca per jam historis didukung hingga 24 jam yang lalu.

Tanggal

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam satu tahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

Lokasi

Representasi JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Kolom
Kolom union location_type. Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut:
latLng

object (LatLng)

Titik yang ditentukan menggunakan koordinat geografis.
placeId

string

ID Tempat yang terkait dengan lokasi .
address

string

Alamat yang dapat dibaca manusia atau plus code. Lihat https://plus.codes untuk mengetahui detailnya.

LatLng

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

UnitsSystem

Mewakili sistem satuan yang digunakan untuk mengukur nilai.

Enum
UNITS_SYSTEM_UNSPECIFIED Sistem unit tidak ditentukan.
IMPERIAL Sistem satuan imperial (misalnya, Fahrenheit, mil, dll.).
METRIC Sistem satuan metrik (misalnya, Celsius, kilometer, dll.).

Skema Output

Respons untuk RPC LookupWeather - mewakili kondisi cuaca di lokasi yang diminta.

Respons ini mewakili informasi Per Jam dan Harian, sehingga respons dibagi menjadi tiga bagian: Per Jam, Harian, dan Bersama. Kolom Only-Hourly, Only-Daily ditandai sebagai opsional. Untuk kolom yang digunakan bersama antara informasi Per Jam dan Harian, beberapa kolom selalu ada sehingga tidak ditandai sebagai opsional, sedangkan kolom lainnya ditandai sebagai opsional karena tidak selalu tersedia.

LookupWeatherResponse

Representasi JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Kolom
weatherCondition

object (WeatherCondition)

Kondisi cuaca
precipitation

object (Precipitation)

Kemungkinan presipitasi dan jumlah presipitasi yang terakumulasi
wind

object (Wind)

Kondisi angin
returnedLocation

object (Location)

Wajib. Lokasi tempat informasi cuaca ditampilkan. Lokasi ini sama dengan lokasi dalam permintaan, tetapi dapat berbeda jika lokasi yang diminta adalah alamat teks bebas yang mencari perkiraan lokasi (misalnya, "Mountain View, CA").
attribution

object (Attribution)

Atribusi yang diperlukan untuk ditampilkan bersama cuaca.

Kolom union _temperature.

_temperature hanya dapat berupa salah satu dari hal berikut:
temperature

object (Temperature)

Suhu per jam

Kolom union _feels_like_temperature.

_feels_like_temperature hanya dapat berupa salah satu dari hal berikut:
feelsLikeTemperature

object (Temperature)

Pengukuran suhu yang dirasakan setiap jam.

Kolom union _heat_index.

_heat_index hanya dapat berupa salah satu dari hal berikut:
heatIndex

object (Temperature)

Suhu indeks panas per jam.

Kolom union _air_pressure.

_air_pressure hanya dapat berupa salah satu dari hal berikut:
airPressure

object (AirPressure)

Kondisi tekanan udara per jam.

Kolom union _max_temperature.

_max_temperature hanya dapat berupa salah satu dari hal berikut:
maxTemperature

object (Temperature)

Suhu maksimum (tinggi) sepanjang hari.

Kolom union _min_temperature.

_min_temperature hanya dapat berupa salah satu dari hal berikut:
minTemperature

object (Temperature)

Suhu minimum (rendah) sepanjang hari.

Kolom union _feels_like_max_temperature.

_feels_like_max_temperature hanya dapat berupa salah satu dari hal berikut:
feelsLikeMaxTemperature

object (Temperature)

Suhu maksimum (tinggi) yang dirasakan sepanjang hari.

Kolom union _feels_like_min_temperature.

_feels_like_min_temperature hanya dapat berupa salah satu dari hal berikut:
feelsLikeMinTemperature

object (Temperature)

Suhu minimum (rendah) yang dirasakan sepanjang hari.

Kolom union _max_heat_index.

_max_heat_index hanya dapat berupa salah satu dari hal berikut:
maxHeatIndex

object (Temperature)

Suhu indeks panas maksimum sepanjang hari.

Kolom union _sun_events.

_sun_events hanya dapat berupa salah satu dari hal berikut:
sunEvents

object (SunEvents)

Peristiwa yang terkait dengan matahari (misalnya, matahari terbit, matahari terbenam).

Kolom union _moon_events.

_moon_events hanya dapat berupa salah satu dari hal berikut:
moonEvents

object (MoonEvents)

Peristiwa yang terkait dengan bulan (misalnya, bulan terbit, bulan terbenam).

Kolom union _relative_humidity.

_relative_humidity hanya dapat berupa salah satu dari hal berikut:
relativeHumidity

integer

Persentase kelembapan relatif (nilai dari 0 hingga 100). Tentukan opsional karena tidak selalu tersedia

Kolom union _uv_index.

_uv_index hanya dapat berupa salah satu dari hal berikut:
uvIndex

integer

Indeks ultraviolet (UV) maksimum. Tentukan opsional karena tidak selalu tersedia

Kolom union _thunderstorm_probability.

_thunderstorm_probability hanya dapat berupa salah satu dari hal berikut:
thunderstormProbability

integer

Probabilitas badai petir (nilai dari 0 hingga 100). Tentukan opsional karena tidak selalu tersedia

Kolom union _cloud_cover.

_cloud_cover hanya dapat berupa salah satu dari hal berikut:
cloudCover

integer

Persentase langit yang tertutup awan (nilai dari 0 hingga 100). Tentukan opsional karena tidak selalu tersedia

Suhu

Representasi JSON 
{
  "unit": enum (TemperatureUnit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Kolom
unit

enum (TemperatureUnit)

Kode untuk unit yang digunakan untuk mengukur nilai suhu.

Kolom union _degrees.

_degrees hanya dapat berupa salah satu dari hal berikut:
degrees

number

Nilai suhu (dalam derajat) dalam unit yang ditentukan.

AirPressure

Representasi JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Kolom

Kolom union _mean_sea_level_millibars.

_mean_sea_level_millibars hanya dapat berupa salah satu dari hal berikut:
meanSeaLevelMillibars

number

Tekanan udara permukaan laut rata-rata dalam milibar.

SunEvents

Representasi JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Kolom
sunriseTime

string (Timestamp format)

Waktu saat matahari terbit.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran Arktik), mungkin tidak ada waktu matahari terbit untuk satu hari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Waktu saat matahari terbenam.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran Arktik), mungkin tidak ada waktu matahari terbenam selama satu hari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

MoonEvents

Representasi JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Kolom
moonriseTimes[]

string (Timestamp format)

Waktu saat bagian atas bulan muncul di atas cakrawala (lihat https://en.wikipedia.org/wiki/Moonrise_and_moonset).

CATATAN: Biasanya, bulan hanya terbit sekali sehari. Dalam kasus lain, daftar mungkin kosong (misalnya, saat bulan terbit setelah tengah malam hari berikutnya). Namun, dalam kasus unik (misalnya di wilayah kutub), daftar tersebut dapat berisi lebih dari satu nilai. Dalam kasus ini, nilai diurutkan dalam urutan menaik.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Waktu saat bagian atas bulan menghilang di bawah cakrawala (lihat https://en.wikipedia.org/wiki/Moonrise_and_moonset).

CATATAN: Biasanya, akan ada satu waktu bulan terbenam per hari. Dalam kasus lain, daftar mungkin kosong (misalnya, saat bulan terbenam setelah tengah malam keesokan harinya). Namun, dalam kasus unik (misalnya di wilayah kutub), daftar tersebut dapat berisi lebih dari satu nilai. Dalam kasus ini, nilai diurutkan dalam urutan menaik.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Fase bulan.

WeatherCondition

Representasi JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Kolom
iconBaseUri

string

URI dasar untuk ikon, tidak termasuk ekstensi jenis file. Untuk menampilkan ikon, tambahkan tema jika diinginkan dan ekstensi jenis file (.png atau .svg) ke URI ini. Secara default, ikon menggunakan tema terang, tetapi _dark dapat ditambahkan untuk mode gelap. Misalnya: "https://maps.gstatic.com/weather/v1/dust.svg" atau "https://maps.gstatic.com/weather/v1/dust_dark.svg", dengan icon_base_uri adalah "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

Deskripsi tekstual untuk kondisi cuaca ini (dilokalkan).
type

enum (Type)

Jenis kondisi cuaca.

LocalizedText

Representasi JSON 
{
  "text": string,
  "languageCode": string
}
Kolom
text

string

String yang dilokalkan dalam bahasa yang sesuai dengan google.type.LocalizedText.language_code di bawah.
languageCode

string

Kode bahasa BCP-47 teks, seperti "en-US" atau "sr-Latn".

Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Presipitasi

Representasi JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Kolom
probability

object (PrecipitationProbability)

Kemungkinan presipitasi (nilai dari 0 hingga 100).
snowQpf

object (QuantitativePrecipitationForecast)

Jumlah salju, yang diukur sebagai setara air cair, yang telah terakumulasi selama jangka waktu tertentu. Catatan: QPF adalah singkatan dari Quantitative Precipitation Forecast (lihat definisi QuantitativePrecipitationForecast untuk mengetahui detail selengkapnya).
qpf

object (QuantitativePrecipitationForecast)

Jumlah presipitasi hujan, yang diukur sebagai setara air cair, yang telah terakumulasi selama jangka waktu tertentu. Catatan: QPF adalah singkatan dari Quantitative Precipitation Forecast (lihat definisi QuantitativePrecipitationForecast untuk mengetahui detail selengkapnya).

PrecipitationProbability

Representasi JSON 
{
  "type": enum (PrecipitationType),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Kolom
type

enum (PrecipitationType)

Kode yang menunjukkan jenis presipitasi.

Kolom union _percent.

_percent hanya dapat berupa salah satu dari hal berikut:
percent

integer

Persentase dari 0 hingga 100 yang menunjukkan peluang presipitasi.

QuantitativePrecipitationForecast

Representasi JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Kolom
unit

enum (Unit)

Kode unit yang digunakan untuk mengukur jumlah akumulasi presipitasi.

Kolom union _quantity.

_quantity hanya dapat berupa salah satu dari hal berikut:
quantity

number

Jumlah presipitasi, yang diukur sebagai setara air cair, yang telah terakumulasi selama jangka waktu tertentu.

Wind

Representasi JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Kolom
direction

object (WindDirection)

Arah angin, sudut asalnya.
speed

object (WindSpeed)

Kecepatan angin.
gust

object (WindSpeed)

Embusan angin (peningkatan kecepatan angin secara tiba-tiba).

WindDirection

Representasi JSON 
{
  "cardinal": enum (CardinalDirection),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Kolom
cardinal

enum (CardinalDirection)

Kode yang mewakili arah mata angin tempat angin bertiup.

Kolom union _degrees.

_degrees hanya dapat berupa salah satu dari hal berikut:
degrees

integer

Arah angin dalam derajat (nilai dari 0 hingga 360).

WindSpeed

Representasi JSON 
{
  "unit": enum (SpeedUnit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Kolom
unit

enum (SpeedUnit)

Kode yang mewakili unit yang digunakan untuk mengukur kecepatan angin.

Kolom union _value.

_value hanya dapat berupa salah satu dari hal berikut:
value

number

Nilai kecepatan angin.

Lokasi

Representasi JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Kolom
Kolom union location_type. Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut:
latLng

object (LatLng)

Titik yang ditentukan menggunakan koordinat geografis.
placeId

string

ID Tempat yang terkait dengan lokasi .
address

string

Alamat yang dapat dibaca manusia atau plus code. Lihat https://plus.codes untuk mengetahui detailnya.

LatLng

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Atribusi

Representasi JSON 
{
  "title": string,
  "url": string
}
Kolom
title

string

Judul yang akan ditampilkan untuk atribusi.
url

string

URL yang akan ditautkan untuk atribusi.

TemperatureUnit

Merepresentasikan unit yang digunakan untuk mengukur suhu.

Enum
TEMPERATURE_UNIT_UNSPECIFIED Satuan suhu tidak ditentukan.
CELSIUS Suhu diukur dalam Celsius.
FAHRENHEIT Suhu diukur dalam Fahrenheit.

MoonPhase

Menandai fase bulan.

Enum
MOON_PHASE_UNSPECIFIED Fase bulan tidak ditentukan.
NEW_MOON Bulan tidak diterangi oleh matahari.
WAXING_CRESCENT Bulan diterangi sebesar 0%-50% di sisi kanannya di belahan bumi utara 🌒 dan di sisi kirinya di belahan bumi selatan 🌘.
FIRST_QUARTER Bulan diterangi sebesar 50,1% di sisi kanannya di belahan bumi utara 🌓 dan di sisi kirinya di belahan bumi selatan 🌗.
WAXING_GIBBOUS Bulan diterangi 50%-100% di sisi kanannya di belahan bumi utara 🌔 dan di sisi kirinya di belahan bumi selatan 🌖.
FULL_MOON Bulan diterangi sepenuhnya.
WANING_GIBBOUS Bulan diterangi 50%-100% di sisi kirinya di belahan bumi utara 🌖 dan di sisi kanannya di belahan bumi selatan 🌔.
LAST_QUARTER Bulan diterangi sebesar 50,1% di sisi kirinya di belahan bumi utara 🌗 dan di sisi kanannya di belahan bumi selatan 🌓.
WANING_CRESCENT Bulan diterangi sebesar 0%-50% di sisi kirinya di belahan bumi utara 🌘 dan di sisi kanannya di belahan bumi selatan 🌒.

Jenis

Menandai jenis kondisi cuaca dalam konteks elemen perkiraan.

Enum
TYPE_UNSPECIFIED Kondisi cuaca tidak ditentukan.
CLEAR Tidak ada awan.
MOSTLY_CLEAR Berawan secara berkala.
PARTLY_CLOUDY Sebagian berawan (beberapa awan).
MOSTLY_CLOUDY Sebagian besar berawan (lebih banyak awan daripada matahari).
CLOUDY Berawan (semua awan, tanpa matahari).
WINDY Angin kencang.
WIND_AND_RAIN Angin kencang disertai presipitasi.
LIGHT_RAIN_SHOWERS Hujan ringan berjeda.
CHANCE_OF_SHOWERS Kemungkinan hujan berjeda.
SCATTERED_SHOWERS Hujan berjeda.
RAIN_SHOWERS Gerimis dianggap sebagai curah hujan yang memiliki durasi lebih singkat daripada hujan, dan ditandai dengan waktu mulai dan berhenti yang tiba-tiba, serta perubahan intensitas yang cepat.
HEAVY_RAIN_SHOWERS Hujan lebat.
LIGHT_TO_MODERATE_RAIN Hujan (dengan intensitas ringan hingga sedang).
MODERATE_TO_HEAVY_RAIN Hujan (dengan intensitas sedang hingga lebat).
RAIN Hujan sedang.
LIGHT_RAIN Hujan ringan.
HEAVY_RAIN Hujan lebat.
RAIN_PERIODICALLY_HEAVY Hujan lebat secara berkala.
LIGHT_SNOW_SHOWERS Salju ringan yang turun dengan intensitas bervariasi dalam waktu singkat.
CHANCE_OF_SNOW_SHOWERS Kemungkinan hujan salju singkat.
SCATTERED_SNOW_SHOWERS Salju yang turun dengan intensitas bervariasi dalam jangka waktu singkat.
SNOW_SHOWERS Hujan salju singkat.
HEAVY_SNOW_SHOWERS Hujan salju lebat.
LIGHT_TO_MODERATE_SNOW Salju ringan hingga sedang.
MODERATE_TO_HEAVY_SNOW Salju sedang hingga lebat.
SNOW Salju sedang.
LIGHT_SNOW Salju ringan.
HEAVY_SNOW Salju lebat.
SNOWSTORM Salju disertai kemungkinan guntur dan petir.
SNOW_PERIODICALLY_HEAVY Salju, terkadang lebat.
HEAVY_SNOW_STORM Salju lebat dengan kemungkinan guntur dan petir.
BLOWING_SNOW Salju disertai angin kencang.
RAIN_AND_SNOW Hujan dan salju.
HAIL Hujan es.
HAIL_SHOWERS Hujan es yang turun dengan intensitas bervariasi dalam waktu singkat.
THUNDERSTORM Badai petir.
THUNDERSHOWER Hujan lebat disertai guntur dan petir.
LIGHT_THUNDERSTORM_RAIN Hujan badai petir ringan.
SCATTERED_THUNDERSTORMS Badai petir yang disertai hujan dengan berbagai intensitas dalam waktu singkat.
HEAVY_THUNDERSTORM Badai petir kencang.

PrecipitationType

Menunjukkan jenis presipitasi di lokasi tertentu.

Enum
PRECIPITATION_TYPE_UNSPECIFIED Jenis presipitasi tidak ditentukan.
NONE Tidak ada presipitasi.
SNOW Presipitasi salju.
RAIN Presipitasi hujan.
LIGHT_RAIN Presipitasi hujan ringan.
HEAVY_RAIN Presipitasi hujan lebat.
RAIN_AND_SNOW Presipitasi hujan dan salju.
SLEET Presipitasi hujan es.
FREEZING_RAIN Presipitasi hujan beku.

Unit

Menunjukkan unit yang digunakan untuk mengukur jumlah akumulasi presipitasi.

Enum
UNIT_UNSPECIFIED Satuan presipitasi tidak ditentukan.
MILLIMETERS Jumlah presipitasi diukur dalam milimeter.
INCHES Jumlah presipitasi diukur dalam inci.

CardinalDirection

Mewakili arah mata angin (termasuk arah ordinal).

Enum
CARDINAL_DIRECTION_UNSPECIFIED Arah mata angin tidak ditentukan.
NORTH Arah mata angin utara.
NORTH_NORTHEAST Arah mata angin sekunder utara-timur laut.
NORTHEAST Arah interkardinal timur laut.
EAST_NORTHEAST Arah interkardinal sekunder timur-timur laut.
EAST Arah mata angin timur.
EAST_SOUTHEAST Arah interkardinal sekunder timur-tenggara.
SOUTHEAST Arah interkardinal tenggara.
SOUTH_SOUTHEAST Arah interkardinal sekunder selatan-tenggara.
SOUTH Arah mata angin selatan.
SOUTH_SOUTHWEST Arah interkardinal sekunder selatan-barat daya.
SOUTHWEST Arah interkardinal barat daya.
WEST_SOUTHWEST Arah interkardinal sekunder barat-barat daya.
WEST Arah mata angin barat.
WEST_NORTHWEST Arah interkardinal sekunder barat-barat laut.
NORTHWEST Arah interkardinal barat laut.
NORTH_NORTHWEST Arah interkardinal sekunder utara-barat laut.

SpeedUnit

Mewakili unit yang digunakan untuk mengukur kecepatan.

Enum
SPEED_UNIT_UNSPECIFIED Unit kecepatan tidak ditentukan.
KILOMETERS_PER_HOUR Kecepatan diukur dalam kilometer per jam.
MILES_PER_HOUR Kecepatan diukur dalam mil per jam.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.
  • idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌