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.

Kullanılabilir Veriler: Sıcaklık (Anlık, Hissedilen, Maksimum/Minimum, Isı İndeksi), Rüzgar (Hız, Esinti, Yön), Gök Olayları (Gündoğumu/Günbatımı, Ay Evresi), Yağış (Tür, Olasılık, Miktar/QPF), Atmosferik Koşullar (UV İndeksi, Nem, Bulut Örtüsü, Fırtına Olasılığı) ve Coğrafi Kodlu Konum Adresi.

Konum ve Konum Kuralları (ÇOK ÖNEMLİ):

Hava durumu verilerinin istendiği konum, location alanı kullanılarak belirtilir. Bu alan bir "oneof" yapısıdır. Bu nedenle, doğru hava durumu verisi araması için aşağıdaki üç konum alt alanından YALNIZCA BİRİNE değer sağlamanız GEREKİR.

  1. Coğrafi koordinatlar (lat_lng)

    • Tam enlem/boylam koordinatları verildiğinde 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 belirli bir bilgi gerektiren serbest biçimli bir dize.
    • Şehir ve Bölge: Bölge/ülke her zaman dahil edilmelidir (ör. "Londra, Birleşik Krallık", "Londra" değil).
    • Açık Adres: Tam adresi girin (ör. "1600 Pennsylvania Ave NW, Washington, DC").
    • Posta kodları: Ülke adıyla birlikte verilmelidir (ör. "90210, ABD", "90210" DEĞİL).
    • Örnek: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Kullanım Modları:

  • Mevcut Hava Durumu: Yalnızca location bilgisini ver. date ve hour özelliklerini belirtmeyin.

  • Saatlik Hava Durumu Tahmini: location, date ve hour (0-23) bilgilerini sağlayın. Belirli zamanlar (ör. "saat 17:00'da") veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi ifadeler için kullanılır. Kullanıcı dakikayı belirtirse en yakın saate yuvarlayın. 120 saatten sonraki saatlik hava durumu tahmini desteklenmez. Geçmiş saatlik hava durumu verileri, 24 saat öncesine kadar desteklenir.

  • Günlük Tahmin: location ve date bilgilerini ver. hour özelliğini belirtmeyin. Genel gün istekleri için kullanılır (ör. "yarın hava nasıl olacak?", "cuma günü hava nasıl olacak?", "25.12'de hava nasıl olacak?"). Bugünün tarihi bağlamda yer almıyorsa kullanıcıya bu durumu açıklamanız gerekir. Bugün de dahil olmak üzere 10 günü aşan 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 göre 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 ediyorsa veya açıkça talep ediyorsa Fahrenheit/Mil için units_system değerini IMPERIAL olarak ayarlayın.

  • Temellendirilmiş çıktı, varsa 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 simgesinin 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 için istek: İstenen konumdaki hava durumu koşullarını gösterir.

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 koşullarının 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 bilgisinin tarihi. Not: Bu tarih, konum alanında belirtilen konumun yerel saat dilimine göre belirlenir. 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 bilgisinin saati, 24 saatlik biçimde (0-23). Bu değer, konum alanında belirtilen konumun yerel saat dilimine göre belirlenir. 120 saatten sonraki saatlik hava durumu tahmini desteklenmez. Geçmiş saatlik hava durumu verileri 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 içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen 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. Yalnızca bir yılı 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

Enlem (derece). [-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 gösterir.

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

Çıkış şeması

LookupWeather RPC'nin yanıtı: İstenen konumdaki hava durumu koşullarını gösterir.

Bu yanıtta hem saatlik hem de günlük bilgiler yer aldığından yanıt; Saatlik, Günlük ve Paylaşılan olmak üzere üç bölüme ayrılmıştır. Yalnızca saatlik ve 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 kullanılamadığı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ğış ihtimali 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, kaba bir konuma (ör. "Mountain View, CA") karşılık gelen serbest metin adresi ise farklı olabilir.
attribution

object (Attribution)

Hava durumuyla birlikte gösterilmesi için ilişkilendirme yapılması gerekir.

_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çüsü.

_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 ölçülen 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 ölçülen 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 (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 en yüksek ı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 olaylar (ö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 olaylar (ö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-100 arasındaki değerler). Her zaman kullanılamadığından isteğe bağlı olarak tanımlanır.

_uv_index birleşik alanı.

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

integer

Maksimum ultraviyole (UV) indeksi. Her zaman kullanılamadığından isteğe bağlı olarak tanımlayın.

_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-100 arasındaki değerler). Her zaman kullanılamadığından isteğe bağlı olarak tanımlanır.

_cloud_cover birleşik alanı.

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

integer

Gökyüzünün bulutlarla kaplı olma yüzdesi (0 ile 100 arasındaki değerler). Her zaman kullanılamadığından isteğe bağlı olarak tanımlanır.

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 ayarlanmamış olur.

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ığı saat.

NOT: Bazı özel durumlarda (ör. Kuzey Kutup Dairesi'nin kuzeyinde) bir gün için gün batımı saati olmayabilir. Bu durumlarda bu alan ayarlanmamış olur.

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 tarihinden itibaren geçen UTC süresini saniye cinsinden gösterir. -62135596800 ile 253402300799 arasında (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir) olmalıdır.
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında (her iki değer de dahil) 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 ufuk çizgisinin üzerinde göründüğü zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, ayın doğuşu günde bir kez gerçekleşir. Diğer durumlarda ise liste boş olabilir (ör. ay, sonraki gün gece yarısından sonra doğduğunda). Ancak, benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer olabilir. 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 kolunun ufuk çizgisinin altında kaybolduğu zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, ayın batma zamanı günde bir kez olur. Diğer durumlarda ise liste boş olabilir (ör. Ay, sonraki gün gece yarısından sonra battığında). Ancak, benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer olabilir. 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 evresi (diğer adıyla ayın evresi).

WeatherCondition

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

string

Dosya türü uzantısı hariç simgenin temel URI'si. Simgeyi görüntülemek için bu URI'ye istenirse bir tema ve dosya türü uzantısı (.png veya .svg) ekleyin. Simge varsayılan olarak 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" olur.
description

object (LocalizedText)

Bu hava durumuyla ilgili metin açıklaması (yerelleştirilmiş).
type

enum (Type)

Hava koşulunun türü.

LocalizedText

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

string

Aşağıdaki google.type.LocalizedText.language_code ile eşleşen dilde 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-100 arasındaki değerler).
snowQpf

object (QuantitativePrecipitationForecast)

Belirli bir süre boyunca biriken kar miktarının sıvı su eşdeğeri olarak ölçülür. Not: QPF, Quantitative Precipitation Forecast (Nicel Yağış Tahmini) ifadesinin 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 yağış miktarının sıvı su eşdeğeri olarak ölçülen değeri. Not: QPF, Quantitative Precipitation Forecast (Nicel Yağış Tahmini) ifadesinin 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 bir kod.

_percent birleşik alanı.

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

integer

Yağmur olasılığını gösteren %0 ile %100 arasında bir değer.

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)

Birikmiş 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 hamlesi (rüzgar hızında 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ü gösteren 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

Enlem (derece). [-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 Fahrenheit cinsinden ölçülür.

MoonPhase

Ay evresini (diğer adıyla ayın evresi) gösterir.

Sıralamalar
MOON_PHASE_UNSPECIFIED Ayın evresi belirtilmedi.
NEW_MOON Ay, güneş tarafından aydınlatılmaz.
WAXING_CRESCENT Ay, Kuzey Yarım Küre'de sağ tarafı %0-50 oranında aydınlatılmış şekilde 🌒, Güney Yarım Küre'de ise sol tarafı% 0-50 oranında aydınlatılmış şekilde 🌘 görünür.
FIRST_QUARTER Ay, Kuzey Yarım Küre'de sağ tarafı %50,1 oranında aydınlatılmış şekilde 🌓, Güney Yarım Küre'de ise sol tarafı %50,1 oranında aydınlatılmış şekilde 🌗 görünür.
WAXING_GIBBOUS Kuzey yarım kürede Ay'ın sağ tarafı (%50-100) 🌔, güney yarım kürede ise sol tarafı (%50-100) 🌖 aydınlanır.
FULL_MOON Ay tamamen aydınlatılmış.
WANING_GIBBOUS Ay, kuzey yarım kürede sol tarafında %50-100, güney yarım kürede ise sağ tarafında% 50-100 oranında ışık alır. 🌖🌔
LAST_QUARTER Ay, kuzey yarım kürede sol tarafı %50,1 oranında 🌗, güney yarım kürede ise sağ tarafı %50,1 oranında 🌓 aydınlatılmış şekilde görünür.
WANING_CRESCENT Ay, kuzey yarım kürede sol tarafı %0-50 oranında aydınlatılmış 🌘, güney yarım kürede ise sağ tarafı% 0-50 oranında aydınlatılmış 🌒 şekilde gösterilir.

Tür

Bir tahmin öğesinin bağlamındaki hava durumu türünü işaretler.

Sıralamalar
TYPE_UNSPECIFIED Hava durumu belirtilmemiş.
CLEAR Bulut yok.
MOSTLY_CLEAR Zaman zaman bulutlu.
PARTLY_CLOUDY Parçalı bulutlu (bazı bulutlar).
MOSTLY_CLOUDY Çok bulutlu (güneşten daha fazla bulut).
CLOUDY Bulutlu (tüm bulutlar, güneş yok).
WINDY Kuvvetli rüzgar.
WIND_AND_RAIN Yağışla birlikte yüksek rüzgar.
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ğmurdan daha kısa süren, başlama ve durma zamanları açısından ani ve yoğunluğunda hızlı değişiklikler olan yağış olarak kabul edilir.
HEAVY_RAIN_SHOWERS Yoğun sağanak yağmur.
LIGHT_TO_MODERATE_RAIN Yağmur (hafif ila orta şiddette)
MODERATE_TO_HEAVY_RAIN Yağmur (orta kuvvette-kuvvetli).
RAIN Orta kuvvette yağmur.
LIGHT_RAIN Hafif yağmur.
HEAVY_RAIN Sağanak yağmur.
RAIN_PERIODICALLY_HEAVY Zaman zaman kuvvetli olmak üzere yağmurlu.
LIGHT_SNOW_SHOWERS Kısa sürelerle değişen yoğunlukta yağan hafif kar.
CHANCE_OF_SNOW_SHOWERS Yer yer kar ihtimali.
SCATTERED_SNOW_SHOWERS Kısa sürelerle değişen yoğunlukta yağan kar.
SNOW_SHOWERS Sağanak kar yağışı.
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 yağışı.
LIGHT_SNOW Hafif kar yağışı.
HEAVY_SNOW Yoğun kar yağışı.
SNOWSTORM Gök gürültüsü ve şimşek ihtimali olan kar yağışı.
SNOW_PERIODICALLY_HEAVY Zaman zaman kuvvetli kar yağışı.
HEAVY_SNOW_STORM Gök gürültüsü ve şimşek olasılığıyla birlikte yoğun kar yağışı.
BLOWING_SNOW Yoğun rüzgarla birlikte kar yağışı.
RAIN_AND_SNOW Yağmur ve kar karışımı.
HAIL Dolu.
HAIL_SHOWERS Kısa süreler boyunca 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şekle birlikte yağan yağmur.
LIGHT_THUNDERSTORM_RAIN Hafif gök gürültülü yağmur.
SCATTERED_THUNDERSTORMS Kısa süreli ve farklı yoğunluklarda yağmur içeren gök gürültülü fırtınalar.
HEAVY_THUNDERSTORM Yoğun şiddetli gök gürültülü fırtına.

PrecipitationType

Belirli bir konumdaki yağış türünü gösterir.

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 Yoğun yağmur yağışı.
RAIN_AND_SNOW Hem yağmur hem de kar yağışı.
SLEET Sulu kar yağışı.
FREEZING_RAIN Donan yağmur yağışı.

Birim

Birikmiş yağış miktarını ölçmek için kullanılan birimi gösterir.

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 belirtilmedi.
NORTH Kuzey ana yönü.
NORTH_NORTHEAST Kuzey-kuzeydoğu ikincil ana yönü.
NORTHEAST Kuzeydoğu ara yönü.
EAST_NORTHEAST Doğu-kuzeydoğu ikincil ana yönü.
EAST Doğu ana yönü.
EAST_SOUTHEAST Doğu-güneydoğu ikincil ana yönü.
SOUTHEAST Güneydoğu ara yönü.
SOUTH_SOUTHEAST Güney-güneydoğu ikincil ana yönü.
SOUTH Güney ana yönü.
SOUTH_SOUTHWEST Güney-güneybatı ikincil ana yönü.
SOUTHWEST Güneybatı ara yönü.
WEST_SOUTHWEST Batı-güneybatı ikincil ana yönü.
WEST Batı ana yönü.
WEST_NORTHWEST Batı-kuzeybatı ikincil ana yönü.
NORTHWEST Kuzeybatı ara yönü.
NORTH_NORTHWEST Kuzey-kuzeybatı ikincil ana yönü.

SpeedUnit

Hızı ölçmek için kullanılan birimi gösterir.

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ç Açıklamaları

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

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa 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ğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerin bulunduğu bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yok Edici İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌