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, Esme, 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ı (KRİTİK):
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.
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
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
Adres Dizesi (adres)
- Coğrafi kodlama için belirli bir biçimde olması gereken 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).
- Posta Adresi: 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
locationbilgisini ver.datevehourözelliklerini belirtmeyin.Saatlik Hava Durumu Tahmini:
location,datevehour(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ı dakika belirtirse en yakın saate yuvarlayın. 120 saatten sonraki saatlik hava durumu tahmini desteklenmez. Geçmiş saatlik hava durumu, 24 saate kadar desteklenir.Günlük Tahmin:
locationvedatebilgilerini ver.hourözelliğini belirtmeyin. Genel gün istekleri için kullanılır (ör. "yarının hava durumu", "cuma gününün hava durumu", "25.12'nin hava durumu"). 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 tahmin desteklenmez. Geçmiş hava durumu desteklenmez.
Parametre Kısıtlamaları:
- Saat dilimleri: Tüm
datevehourgiriş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
METRICdeğerine ayarlanır. Kullanıcı ABD standartlarını ima ediyorsa veya açıkça talep ediyorsa Fahrenheit/Mil içinunits_systemdeğeriniIMPERIALolarak ayarlayın. Temellendirilmiş çıktı, varsa
attributionalanındaki bilgiler kullanılarak kaynağa atfedilmelidir.
Aşağıdaki örnekte, curl kullanılarak lookup_weather MCP aracının nasıl çağrı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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Giriş Şeması
LookupWeather yöntemi için istek: İstenen konumdaki hava koşullarını gösterir.
LookupWeatherRequest
| JSON gösterimi |
|---|
{ "DEPRECATEDAddress": string, "unitsSystem": enum ( |
| Alanlar | |
|---|---|
DEPRECATEDAddress |
DEPRECATED: Use location instead. |
unitsSystem |
İsteğe bağlı. 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 |
Zorunlu. Hava durumu koşullarının alınacağı konum. |
|
|
date |
İsteğe bağlı. 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 |
İsteğe bağlı. İstenen hava durumu bilgisinin saati, 24 saat biçiminde (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, 24 saate kadar desteklenir. |
Tarih
| JSON gösterimi |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Alanlar | |
|---|---|
year |
Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
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 |
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 değeri kullanılabilir. |
Konum
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden yalnızca biri olabilir: |
|
latLng |
Coğrafi koordinatlar kullanılarak belirtilen bir nokta. |
placeId |
Konumla ilişkili yer kimliği . |
address |
Kullanıcı tarafından okunabilir 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 |
Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır. |
longitude |
Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır. |
Çı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 ( |
| Alanlar | |
|---|---|
weatherCondition |
Hava durumu |
precipitation |
Yağış olasılığı ve biriken yağış miktarı |
wind |
Rüzgar koşulları |
DEPRECATEDGeocodedAddress |
DESTEĞİ SONLANDIRILDI: Bunun yerine returned_location özelliğini kullanın. |
returnedLocation |
Zorunlu. Hava durumu bilgilerinin döndürüldüğü konum. Bu konum, istekteki konumla aynıdır ancak istenen konum, yaklaşık bir konuma (ör. "Mountain View, CA") karşılık gelen serbest metinli bir adres ise farklı olabilir. |
attribution |
Hava durumuyla birlikte gösterilmesi için ilişkilendirme yapılması gerekir. |
|
|
temperature |
Saatlik sıcaklık |
|
|
feelsLikeTemperature |
Sıcaklığın nasıl hissedildiğinin saatlik ölçüsü. |
|
|
heatIndex |
Saatlik ısı endeksi sıcaklığı. |
|
|
airPressure |
Saatlik hava basıncı koşulları. |
|
|
maxTemperature |
Gün boyunca ölçülen maksimum (yüksek) sıcaklık. |
|
|
minTemperature |
Gün boyunca ölçülen minimum (düşük) sıcaklık. |
|
|
feelsLikeMaxTemperature |
Gün boyunca hissedilen maksimum (yüksek) sıcaklık. |
|
|
feelsLikeMinTemperature |
Gün boyunca hissedilen minimum (düşük) sıcaklık. |
|
|
maxHeatIndex |
Gün boyunca ölçülen en yüksek ısı indeksi sıcaklığı. |
|
|
sunEvents |
Güneşle ilgili olaylar (ör. gün doğumu, gün batımı). |
|
|
moonEvents |
Ayla ilgili olaylar (ör. ayın doğuşu, ayın batışı). |
|
|
relativeHumidity |
Bağıl nem yüzdesi (0-100 arasındaki değerler). Her zaman kullanılamadığı için isteğe bağlı olarak tanımlanır. |
|
|
uvIndex |
Maksimum ultraviyole (UV) indeksi. Her zaman kullanılamadığından isteğe bağlı olarak tanımlayın. |
|
|
thunderstormProbability |
Fırtına olasılığı (0-100 arasındaki değerler). Her zaman kullanılamadığından isteğe bağlı olarak tanımlanır. |
|
|
cloudCover |
Gökyüzünün bulutlarla kaplı olma yüzdesi (0-100 arasındaki değerler). Her zaman kullanılamadığından isteğe bağlı olarak tanımlayın. |
Sıcaklık
| JSON gösterimi |
|---|
{ "unit": enum ( |
| Alanlar | |
|---|---|
unit |
Sıcaklık değerini ölçmek için kullanılan birimin kodu. |
|
|
degrees |
Belirtilen birimdeki sıcaklık değeri (derece cinsinden). |
AirPressure
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
|
|
meanSeaLevelMillibars |
Milibar cinsinden ortalama deniz seviyesi hava basıncı. |
SunEvents
| JSON gösterimi |
|---|
{ "sunriseTime": string, "sunsetTime": string } |
| Alanlar | |
|---|---|
sunriseTime |
Güneşin doğduğu saat. 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ış olarak kalı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: |
sunsetTime |
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ış olarak kalı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: |
Zaman damgası
| JSON gösterimi |
|---|
{ "seconds": string, "nanos": integer } |
| Alanlar | |
|---|---|
seconds |
Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir). |
nanos |
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 olmalıdır (bu değerler dahil). |
MoonEvents
| JSON gösterimi |
|---|
{
"moonriseTimes": [
string
],
"moonsetTimes": [
string
],
"moonPhase": enum ( |
| Alanlar | |
|---|---|
moonriseTimes[] |
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: |
moonsetTimes[] |
Ayın üst kısmının 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: |
moonPhase |
Ay evresi (diğer adıyla ayın evresi). |
WeatherCondition
| JSON gösterimi |
|---|
{ "iconBaseUri": string, "description": { object ( |
| Alanlar | |
|---|---|
iconBaseUri |
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ı ( |
description |
Bu hava durumu için metin açıklaması (yerelleştirilmiş). |
type |
Hava koşulunun türü. |
LocalizedText
| JSON gösterimi |
|---|
{ "text": string, "languageCode": string } |
| Alanlar | |
|---|---|
text |
Aşağıdaki |
languageCode |
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 ( |
| Alanlar | |
|---|---|
probability |
Yağış olasılığı (0 ile 100 arasındaki değerler). |
snowQpf |
Belirli bir süre boyunca biriken kar miktarının sıvı su eşdeğeri olarak ölçülmüş hali. Not: QPF, Yağış Sayısal Tahmini'nin kısaltmasıdır (daha fazla bilgi için lütfen QuantitativePrecipitationForecast tanımına bakın). |
qpf |
Belirli bir süre boyunca biriken yağış miktarının sıvı su eşdeğeri olarak ölçülen değeri. Not: QPF, Yağış Sayısal 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 ( |
| Alanlar | |
|---|---|
type |
Yağış türünü gösteren bir kod. |
|
|
percent |
Yağmur olasılığını gösteren, 0 ile 100 arasındaki bir yüzdedir. |
QuantitativePrecipitationForecast
| JSON gösterimi |
|---|
{ "unit": enum ( |
| Alanlar | |
|---|---|
unit |
Biriken yağış miktarını ölçmek için kullanılan birimin kodu. |
|
|
quantity |
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 ( |
| Alanlar | |
|---|---|
direction |
Rüzgarın yönü, geldiği açı. |
speed |
Rüzgarın hızı. |
gust |
Rüzgar hamlesi (rüzgar hızında ani artış). |
WindDirection
| JSON gösterimi |
|---|
{ "cardinal": enum ( |
| Alanlar | |
|---|---|
cardinal |
Rüzgarın estiği ana yönü gösteren kod. |
|
|
degrees |
Rüzgarın derece cinsinden yönü (0 ile 360 arasındaki değerler). |
WindSpeed
| JSON gösterimi |
|---|
{ "unit": enum ( |
| Alanlar | |
|---|---|
unit |
Rüzgar hızını ölçmek için kullanılan birimi temsil eden kod. |
|
|
value |
Rüzgar hızının değeri. |
Konum
| JSON gösterimi |
|---|
{ // Union field |
| Alanlar | |
|---|---|
location_type birleşik alanı. Bir konumu temsil etmenin farklı yolları. location_type aşağıdakilerden yalnızca biri olabilir: |
|
latLng |
Coğrafi koordinatlar kullanılarak belirtilen bir nokta. |
placeId |
Konumla ilişkili yer kimliği . |
address |
Kullanıcı tarafından okunabilir 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 |
Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır. |
longitude |
Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır. |
İlişkilendirme
| JSON gösterimi |
|---|
{ "title": string, "url": string } |
| Alanlar | |
|---|---|
title |
İlişkilendirme için gösterilecek başlık. |
url |
İlişkilendirme için bağlantı verilecek URL. |
Araç Ek Açıklamaları
Yıkıcı İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌