MCP Tools Reference: mapstools.googleapis.com

Araç: lookup_weather

Mevcut koşullar, saatlik ve günlük tahminler dahil olmak üzere kapsamlı hava durumu verilerini alır.

Mevcut Veriler: Sıcaklık (Mevcut, Hissedilen, Maks./Min., Isı İndeksi), Rüzgar (Hız, Şiddetli Rüzgar, Yön), Gökyüzü Olayları (Gün Doğumu/Gün Batımı, Ayın Evresi), Yağış (Tür, Olasılık, Miktar/QPF), Atmosfer Koşulları (UV İndeksi, Nem, Bulut Örtüsü, Gök Gürültülü Fırtına Olasılığı) ve Coğrafi Kodlanmış Konum Adresi.

Konum ve Konum Kuralları (KRİTİK):

Hava durumu verilerinin istendiği konum, location alanı kullanılarak belirtilir. Bu alan, "oneof" yapısındadır. Yani hava durumu verilerinin doğru şekilde aranması için aşağıdaki üç konum alt alanından YALNIZCA BİRİNE değer girmeniz GEREKİR.

  1. Coğrafi Koordinatlar (lat_lng)

    • Tam enlem/boylam koordinatları sağlandığında bu seçeneği kullanın.
    • Örnek: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. Yer kimliği (place_id)

    • Net bir dize tanımlayıcısı (Google Haritalar yer kimliği).
    • place_id, search_places aracından alınabilir.
    • Örnek: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eyfel Kulesi

  3. Adres Dizesi (address)

    • Coğrafi kodlama için spesifiklik gerektiren serbest biçimli bir dize.
    • Şehir ve bölge: Her zaman bölgeyi/ülkeyi ekleyin (ör. "Londra" değil, "Londra, Birleşik Krallık").
    • Açık adres: Tam adresi girin (ör. "1600 Pennsylvania Ave NW, Washington, DC").
    • Posta Kodları: Ülke adıyla birlikte GİRİLMELİDİR (ör. "90210, ABD", "90210" DEĞİL).
    • Örnek: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Kullanım Modları:

  • Mevcut Hava Durumu: Yalnızca location değerini sağlayın. date ve hour değerlerini belirtmeyin.

  • Saatlik Tahmin: location, date ve hour (0-23) değerlerini girin. Belirli saatler (ör. "saat 17:00'de") veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi ifadeler için kullanın. Kullanıcı dakika belirtirse en yakın saate yuvarlayın. Şu andan itibaren 120 saati aşan saatlik tahminler desteklenmez. Geçmiş saatlik hava durumu, son 24 saate kadar desteklenir.

  • Günlük tahmin: location ve date değerlerini girin. hour özelliğini belirtmeyin. Genel gün istekleri için kullanın (ör. "yarınki hava durumu", "Cuma günkü hava durumu", "25 Aralık'taki hava durumu"). Bağlamda bugünün tarihi yoksa kullanıcıdan bu bilgiyi istemeniz gerekir. Bugün dahil olmak üzere 10 günden sonraki günlük tahminler desteklenmez. Geçmiş hava durumu desteklenmez.

Parametre kısıtlamaları:

  • Saat dilimleri: Tüm date ve hour girişleri, kullanıcının saat dilimine değil, konumun yerel saat dilimine göre olmalıdır.
  • Tarih Biçimi: Girişler {year, month, day} tam sayıya ayrılmalıdır.
  • Birimler: Varsayılan olarak METRIC değerine ayarlanır. Kullanıcı ABD standartlarını ima ederse veya açıkça talep ederse Fahrenheit/mil için units_system değerini IMPERIAL olarak ayarlayın.

  • Temellendirilmiş çıkış, mümkün olduğunda attribution alanındaki bilgiler kullanılarak kaynağa atfedilmelidir.

Aşağıdaki kod örneğinde, lookup_weather MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş şeması

LookupWeather yöntemi isteği: İstenen konumdaki hava durumu koşullarını temsil eder.

LookupWeatherRequest

JSON gösterimi 
{
  "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.
}
Alanlar
unitsSystem

enum (UnitsSystem)

İsteğe bağlıdır. Döndürülen hava durumu koşulları için kullanılacak birim sistemi. Belirtilmezse döndürülen hava durumu koşulları metrik sistemde olur (varsayılan = METRIC).
location

object (Location)

Zorunlu. Hava durumu bilgilerinin alınacağı konum.

_date birleşik alanı.

_date aşağıdakilerden yalnızca biri olabilir:
date

object (Date)

İsteğe bağlıdır. Gerekli hava durumu bilgilerinin tarihi. Not: Bu tarih, konum alanında belirtilen konumun yerel saat dilimine göredir. Tarih, son 24 saat ile önümüzdeki 10 gün arasında olmalıdır.

_hour birleşik alanı.

_hour aşağıdakilerden yalnızca biri olabilir:
hour

integer

İsteğe bağlıdır. İstenen hava durumu bilgilerinin saati, 24 saat biçiminde (0-23). Bu değer, konum alanında belirtilen konumun yerel saat dilimine göredir. Şu andan itibaren 120 saati aşan saatlik tahminler desteklenmez. Geçmiş saatlik hava durumu, son 24 saate kadar desteklenir.

Tarih

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalıdır veya yıl olmadan bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalıdır. Ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yılı tek başına veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

Konum

JSON gösterimi 
{

  // 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.
}
Alanlar
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden yalnızca biri olabilir:
latLng

object (LatLng)

Coğrafi koordinatlar kullanılarak belirtilen bir nokta.
placeId

string

Konumla ilişkili yer kimliği .
address

string

Kullanıcıların okuyabileceği adres veya Plus Code. Ayrıntılar için https://plus.codes adresini ziyaret edin.

LatLng

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180,0, +180,0] aralığında olmalıdır.

UnitsSystem

Değerleri ölçmek için kullanılan birim sistemini temsil eder.

Sıralamalar
UNITS_SYSTEM_UNSPECIFIED Birim sistemi belirtilmemiş.
IMPERIAL İngiliz ölçü birimleri sistemi (ör. fahrenhayt, mil vb.)
METRIC Metrik birim sistemi (ör.santigrat, kilometre vb.).

Çıkış şeması

LookupWeather RPC'si için yanıt: İstenen konumdaki hava durumu koşullarını temsil eder.

Bu yanıt hem saatlik hem de günlük bilgileri temsil ettiğinden üç bölüme ayrılmıştır: Saatlik, Günlük ve Paylaşılan. Yalnızca Saatlik, Yalnızca Günlük alanları isteğe bağlı olarak işaretlenir. Saatlik ve günlük bilgiler arasında paylaşılan alanlardan bazıları her zaman mevcut olduğundan isteğe bağlı olarak işaretlenmez. Diğerleri ise her zaman mevcut olmadığından isteğe bağlı olarak işaretlenir.

LookupWeatherResponse

JSON gösterimi 
{
  "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.
}
Alanlar
weatherCondition

object (WeatherCondition)

Hava durumu
precipitation

object (Precipitation)

Yağış olasılığı ve biriken yağış miktarı
wind

object (Wind)

Rüzgar koşulları
returnedLocation

object (Location)

Zorunlu. Hava durumu bilgilerinin döndürüldüğü konum. Bu konum, istekteki konumla aynıdır ancak istenen konum, yaklaşık konumu (ör. "Mountain View, CA") arayan serbest metin adresiyse farklı olabilir.
attribution

object (Attribution)

Hava durumuyla birlikte gösterilmesi gereken ilişkilendirme.

_temperature birleşik alanı.

_temperature aşağıdakilerden yalnızca biri olabilir:
temperature

object (Temperature)

Saatlik sıcaklık

_feels_like_temperature birleşik alanı.

_feels_like_temperature aşağıdakilerden yalnızca biri olabilir:
feelsLikeTemperature

object (Temperature)

Sıcaklığın nasıl hissedildiğinin saatlik ölçümü.

_heat_index birleşik alanı.

_heat_index aşağıdakilerden yalnızca biri olabilir:
heatIndex

object (Temperature)

Saatlik ısı endeksi sıcaklığı.

_air_pressure birleşik alanı.

_air_pressure aşağıdakilerden yalnızca biri olabilir:
airPressure

object (AirPressure)

Saatlik hava basıncı koşulları.

_max_temperature birleşik alanı.

_max_temperature aşağıdakilerden yalnızca biri olabilir:
maxTemperature

object (Temperature)

Gün boyunca maksimum (yüksek) sıcaklık.

_min_temperature birleşik alanı.

_min_temperature aşağıdakilerden yalnızca biri olabilir:
minTemperature

object (Temperature)

Gün boyunca minimum (düşük) sıcaklık.

_feels_like_max_temperature birleşik alanı.

_feels_like_max_temperature aşağıdakilerden yalnızca biri olabilir:
feelsLikeMaxTemperature

object (Temperature)

Gün boyunca hissedilen maksimum (en yüksek) sıcaklık.

_feels_like_min_temperature birleşik alanı.

_feels_like_min_temperature aşağıdakilerden yalnızca biri olabilir:
feelsLikeMinTemperature

object (Temperature)

Gün boyunca hissedilen minimum (düşük) sıcaklık.

_max_heat_index birleşik alanı.

_max_heat_index aşağıdakilerden yalnızca biri olabilir:
maxHeatIndex

object (Temperature)

Gün boyunca ölçülen maksimum ısı endeksi sıcaklığı.

_sun_events birleşik alanı.

_sun_events aşağıdakilerden yalnızca biri olabilir:
sunEvents

object (SunEvents)

Güneşle ilgili etkinlikler (ör. gün doğumu, gün batımı).

_moon_events birleşik alanı.

_moon_events aşağıdakilerden yalnızca biri olabilir:
moonEvents

object (MoonEvents)

Ay ile ilgili etkinlikler (ör. ayın doğuşu, ayın batışı).

_relative_humidity birleşik alanı.

_relative_humidity aşağıdakilerden yalnızca biri olabilir:
relativeHumidity

integer

Bağıl nem yüzdesi (0 ile 100 arasındaki değerler). Her zaman mevcut olmadığı için isteğe bağlı olarak tanımlayın.

_uv_index birleşik alanı.

_uv_index aşağıdakilerden yalnızca biri olabilir:
uvIndex

integer

Maksimum ultraviyole (UV) endeksi. Her zaman mevcut olmadığı için isteğe bağlı olarak tanımlanır.

_thunderstorm_probability birleşik alanı.

_thunderstorm_probability aşağıdakilerden yalnızca biri olabilir:
thunderstormProbability

integer

Gök gürültülü fırtına olasılığı (0 ile 100 arasında değerler). Her zaman mevcut olmadığı için isteğe bağlı olarak tanımlayın.

_cloud_cover birleşik alanı.

_cloud_cover aşağıdakilerden yalnızca biri olabilir:
cloudCover

integer

Gökyüzünün bulutlarla kaplı yüzdesi (0 ile 100 arasında değerler). Her zaman mevcut olmadığı için isteğe bağlı olarak tanımlayın.

Sıcaklık

JSON gösterimi 
{
  "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.
}
Alanlar
unit

enum (TemperatureUnit)

Sıcaklık değerini ölçmek için kullanılan birimin kodu.

_degrees birleşik alanı.

_degrees aşağıdakilerden yalnızca biri olabilir:
degrees

number

Belirtilen birimdeki sıcaklık değeri (derece cinsinden).

AirPressure

JSON gösterimi 
{

  // 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.
}
Alanlar

_mean_sea_level_millibars birleşik alanı.

_mean_sea_level_millibars aşağıdakilerden yalnızca biri olabilir:
meanSeaLevelMillibars

number

Milibar cinsinden ortalama deniz seviyesi hava basıncı.

SunEvents

JSON gösterimi 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Alanlar
sunriseTime

string (Timestamp format)

Güneşin doğduğu zaman.

NOT: Bazı özel durumlarda (ör. Kuzey Kutup Dairesi'nin kuzeyinde) bir gün için gün doğumu saati olmayabilir. Bu durumlarda bu alan ayarlanmaz.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Güneşin battığı zaman.

NOT: Bazı özel durumlarda (ör. Kuzey Kutup Dairesi'nin kuzeyinde) gün batımı saati olmayabilir. Bu durumlarda bu alan ayarlanmaz.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z'den bu yana geçen UTC zamanının saniye cinsinden değerini temsil eder. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z arasına karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, saniyenin negatif olmayan kesirleri. Bu alan, sürenin nanosaniye kısmıdır, saniyeye alternatif değildir. Kesirli negatif saniye değerleri, zamanı ileriye doğru sayan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 (her iki değer de dahil) arasında olmalıdır.

MoonEvents

JSON gösterimi 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Alanlar
moonriseTimes[]

string (Timestamp format)

Ay'ın üst kısmının ufukta göründüğü zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, her gün tek bir ay doğumu zamanı olur. Diğer durumlarda liste boş olabilir (ör. ay ertesi gün gece yarısından sonra doğduğunda). Ancak benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer bulunabilir. Bu durumlarda değerler artan düzende sıralanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Ay'ın üst kenarının ufuk çizgisinin altında kaybolduğu zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, her gün için tek bir ay batımı saati olur. Diğer durumlarda liste boş olabilir (ör. ay ertesi gün gece yarısından sonra battığında). Ancak benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer bulunabilir. Bu durumlarda değerler artan düzende sıralanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Ay'ın evresi.

WeatherCondition

JSON gösterimi 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Alanlar
iconBaseUri

string

Dosya türü uzantısını içermeyen simgenin temel URI'si. Simgeyi görüntülemek için bu URI'ye bir tema (isteğe bağlı) ve dosya türü uzantısı (.png veya .svg) ekleyin. Varsayılan olarak simge açık temalıdır ancak koyu mod için _dark eklenebilir. Örneğin: "https://maps.gstatic.com/weather/v1/dust.svg" veya "https://maps.gstatic.com/weather/v1/dust_dark.svg". Burada icon_base_uri, "https://maps.gstatic.com/weather/v1/dust" değerini temsil eder.
description

object (LocalizedText)

Bu hava durumu koşulunun metin açıklaması (yerelleştirilmiş).
type

enum (Type)

Hava durumu türü.

LocalizedText

JSON gösterimi 
{
  "text": string,
  "languageCode": string
}
Alanlar
text

string

Aşağıdaki google.type.LocalizedText.language_code diline karşılık gelen yerelleştirilmiş dize.
languageCode

string

Metnin BCP-47 dil kodu (ör. "en-US" veya "sr-Latn").

Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin.

Yağış

JSON gösterimi 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Alanlar
probability

object (PrecipitationProbability)

Yağış olasılığı (0 ile 100 arasındaki değerler).
snowQpf

object (QuantitativePrecipitationForecast)

Belirli bir süre boyunca biriken ve sıvı su eşdeğeri olarak ölçülen kar miktarı. Not: QPF, Nicel Yağış Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın).
qpf

object (QuantitativePrecipitationForecast)

Belirli bir süre boyunca biriken ve sıvı su eşdeğeri olarak ölçülen yağmur miktarı. Not: QPF, Nicel Yağış Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın).

PrecipitationProbability

JSON gösterimi 
{
  "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.
}
Alanlar
type

enum (PrecipitationType)

Yağış türünü gösteren kod.

_percent birleşik alanı.

_percent aşağıdakilerden yalnızca biri olabilir:
percent

integer

Yağış olasılığını gösteren 0 ile 100 arasında bir yüzde.

QuantitativePrecipitationForecast

JSON gösterimi 
{
  "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.
}
Alanlar
unit

enum (Unit)

Biriken yağış miktarını ölçmek için kullanılan birimin kodu.

_quantity birleşik alanı.

_quantity aşağıdakilerden yalnızca biri olabilir:
quantity

number

Belirli bir süre boyunca biriken ve sıvı su eşdeğeri olarak ölçülen yağış miktarı.

Rüzgar

JSON gösterimi 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Alanlar
direction

object (WindDirection)

Rüzgarın yönü, geldiği açı.
speed

object (WindSpeed)

Rüzgarın hızı.
gust

object (WindSpeed)

Rüzgar hızı (rüzgar hızındaki ani artış).

WindDirection

JSON gösterimi 
{
  "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.
}
Alanlar
cardinal

enum (CardinalDirection)

Rüzgarın estiği ana yönü temsil eden kod.

_degrees birleşik alanı.

_degrees aşağıdakilerden yalnızca biri olabilir:
degrees

integer

Rüzgarın derece cinsinden yönü (0 ile 360 arasındaki değerler).

WindSpeed

JSON gösterimi 
{
  "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.
}
Alanlar
unit

enum (SpeedUnit)

Rüzgar hızını ölçmek için kullanılan birimi temsil eden kod.

_value birleşik alanı.

_value aşağıdakilerden yalnızca biri olabilir:
value

number

Rüzgar hızının değeri.

Konum

JSON gösterimi 
{

  // 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.
}
Alanlar
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden yalnızca biri olabilir:
latLng

object (LatLng)

Coğrafi koordinatlar kullanılarak belirtilen bir nokta.
placeId

string

Konumla ilişkili yer kimliği .
address

string

Kullanıcıların okuyabileceği adres veya Plus Code. Ayrıntılar için https://plus.codes adresini ziyaret edin.

LatLng

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Derece cinsinden enlem. [-90,0, +90,0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180,0, +180,0] aralığında olmalıdır.

İlişkilendirme

JSON gösterimi 
{
  "title": string,
  "url": string
}
Alanlar
title

string

İlişkilendirme için gösterilecek başlık.
url

string

İlişkilendirme için bağlantı verilecek URL.

TemperatureUnit

Sıcaklıkları ölçmek için kullanılan bir birimi temsil eder.

Sıralamalar
TEMPERATURE_UNIT_UNSPECIFIED Sıcaklık birimi belirtilmemiş.
CELSIUS Sıcaklık santigrat cinsinden ölçülür.
FAHRENHEIT Sıcaklık, fahrenhayt cinsinden ölçülür.

MoonPhase

Ay'ın evresini gösterir.

Sıralamalar
MOON_PHASE_UNSPECIFIED Belirtilmemiş ay evresi.
NEW_MOON Ay, güneş tarafından aydınlatılmaz.
WAXING_CRESCENT Ay, Kuzey Yarımküre'de sağ tarafında 🌒, Güney Yarımküre'de ise sol tarafında 🌘 %0-50 oranında aydınlatılır.
FIRST_QUARTER Ay, Kuzey Yarımküre'de sağ tarafından 🌓, Güney Yarımküre'de ise sol tarafından 🌗% 50,1 oranında aydınlatılır.
WAXING_GIBBOUS Ay, kuzey yarımkürede sağ tarafında %50-%100 🌔, güney yarımkürede ise sol tarafında %50-%100 🌖 oranında aydınlatılır.
FULL_MOON Ay tamamen aydınlatılmıştır.
WANING_GIBBOUS Ay, kuzey yarımkürede sol tarafında %50-%100 🌖, güney yarımkürede ise sağ tarafında %50-%100 🌔 oranında aydınlatılır.
LAST_QUARTER Ay, kuzey yarımkürede sol tarafında %50,1 🌗, güney yarımkürede ise sağ tarafında %50,1 🌓 oranında aydınlatılır.
WANING_CRESCENT Ay, kuzey yarımkürede sol tarafında %0-%50 🌘, güney yarımkürede ise sağ tarafında %0-%50 🌒 oranında aydınlatılır.

Tür

Hava durumu tahmini öğesinin bağlamında hava durumu türünü işaretler.

Sıralamalar
TYPE_UNSPECIFIED Hava durumu belirtilmemiş.
CLEAR Bulut yok.
MOSTLY_CLEAR Aralıklı bulutlu.
PARTLY_CLOUDY Parçalı bulutlu (biraz bulutlu).
MOSTLY_CLOUDY Çoğunlukla bulutlu (güneşten çok bulut var).
CLOUDY Bulutlu (güneş yok, her yer bulutlu).
WINDY Şiddetli rüzgar.
WIND_AND_RAIN Yağışlı ve şiddetli rüzgarlı.
LIGHT_RAIN_SHOWERS Aralıklı hafif yağmur.
CHANCE_OF_SHOWERS Aralıklı yağmur ihtimali.
SCATTERED_SHOWERS Aralıklı yağmur.
RAIN_SHOWERS Sağanak, yağmura kıyasla daha kısa süren, başlangıç ve bitiş zamanları açısından ani olan ve yoğunluğunda hızlı değişiklikler görülen yağış türüdür.
HEAVY_RAIN_SHOWERS Şiddetli sağanak yağış.
LIGHT_TO_MODERATE_RAIN Yağmur (hafif ila orta şiddette).
MODERATE_TO_HEAVY_RAIN Yağmur (orta ila yoğun şiddette).
RAIN Orta kuvvette yağmur.
LIGHT_RAIN Hafif yağmurlu.
HEAVY_RAIN Şiddetli yağmur.
RAIN_PERIODICALLY_HEAVY Zaman zaman kuvvetli olmak üzere yağmurlu.
LIGHT_SNOW_SHOWERS Kısa sürelerle farklı yoğunluklarda yağan hafif kar.
CHANCE_OF_SNOW_SHOWERS Yer yer kar ihtimali.
SCATTERED_SNOW_SHOWERS Kısa sürelerle farklı yoğunluklarda yağan kar.
SNOW_SHOWERS Kar sağanağı.
HEAVY_SNOW_SHOWERS Sağanak kar yağışı.
LIGHT_TO_MODERATE_SNOW Hafif ila orta şiddette kar yağışı.
MODERATE_TO_HEAVY_SNOW Orta ila yoğun şiddette kar yağışı.
SNOW Orta kuvvette kar.
LIGHT_SNOW Hafif kar yağışlı.
HEAVY_SNOW Yoğun kar yağışlı.
SNOWSTORM Kar yağışlı, gök gürültülü ve şimşekli olabilir.
SNOW_PERIODICALLY_HEAVY Ara sıra yoğun kar yağışı.
HEAVY_SNOW_STORM Şimşek ve gök gürültüsüyle birlikte yoğun kar yağışı.
BLOWING_SNOW Şiddetli rüzgarla birlikte kar yağışı.
RAIN_AND_SNOW Karla karışık yağmur.
HAIL Dolu
HAIL_SHOWERS Kısa sürelerle farklı yoğunluklarda yağan dolu.
THUNDERSTORM Gök gürültülü fırtına.
THUNDERSHOWER Gök gürültüsü ve şimşek eşliğinde yağan yağmur.
LIGHT_THUNDERSTORM_RAIN Hafif gök gürültülü yağmur.
SCATTERED_THUNDERSTORMS Kısa süreli, farklı şiddetlerde yağmurun eşlik ettiği gök gürültülü fırtına.
HEAVY_THUNDERSTORM Yoğun gök gürültülü fırtına.

PrecipitationType

Belirli bir konumdaki yağış türünü temsil eder.

Sıralamalar
PRECIPITATION_TYPE_UNSPECIFIED Belirtilmemiş yağış türü.
NONE Yağış yok.
SNOW Kar yağışı.
RAIN Yağmur yağışı.
LIGHT_RAIN Hafif yağmur yağışı.
HEAVY_RAIN Şiddetli yağmur yağışı.
RAIN_AND_SNOW Hem yağmur hem de kar yağışı.
SLEET Sulu kar yağışı.
FREEZING_RAIN Donan yağmur yağışı.

Birim

Biriken yağış miktarını ölçmek için kullanılan birimi temsil eder.

Sıralamalar
UNIT_UNSPECIFIED Belirtilmemiş yağış birimi.
MILLIMETERS Yağış miktarı milimetre cinsinden ölçülür.
INCHES Yağış miktarı inç cinsinden ölçülür.

CardinalDirection

Ana yönü (ara yönler dahil) temsil eder.

Sıralamalar
CARDINAL_DIRECTION_UNSPECIFIED Ana yön belirtilmemiş.
NORTH Kuzey yönü.
NORTH_NORTHEAST Kuzey-kuzeydoğu ikincil ara yönü.
NORTHEAST Kuzeydoğu ara yönü.
EAST_NORTHEAST Doğu-kuzeydoğu ikincil ara yönü.
EAST Doğu yönü.
EAST_SOUTHEAST Doğu-güneydoğu ikincil ara yönü.
SOUTHEAST Güneydoğu ara yönü.
SOUTH_SOUTHEAST Güney-güneydoğu ikincil ara yönü.
SOUTH Güney ana yönü.
SOUTH_SOUTHWEST Güney-güneybatı ikincil ara yönü.
SOUTHWEST Güneybatı ara yönü.
WEST_SOUTHWEST Batı-güneybatı ikincil ara yönü.
WEST Batı yönü.
WEST_NORTHWEST Batı-kuzeybatı ikincil ara yönü.
NORTHWEST Kuzeybatı ara yönü.
NORTH_NORTHWEST Kuzey-kuzeybatı ikincil ara yönü.

SpeedUnit

Hızı ölçmek için kullanılan birimi temsil eder.

Sıralamalar
SPEED_UNIT_UNSPECIFIED Hız birimi belirtilmedi.
KILOMETERS_PER_HOUR Hız, kilometre/saat cinsinden ölçülür.
MILES_PER_HOUR Hız, mil/saat cinsinden ölçülür.

Araç Notları

Araç notları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olmayan olarak değerlendirir ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Eşgüçlü İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌