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ı sağlamak için aşağıdaki üç konum alt alanından YALNIZCA BİRİ için değer sağlamanız GEREKİR. 1. Coğrafi Koordinatlar (lat_lng) * Tam enlem/boylam koordinatları sağlandığında kullanın. * Örnek: "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: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eyfel Kulesi 3. Adres Dizesi (address) * Coğrafi kodlama için belirli bir adresin girilmesi gereken serbest biçimli bir dizedir. * Şehir ve Bölge: Bölge/ülke her zaman dahil edilmelidir (ör. "London, UK" (Londra, Birleşik Krallık) gibi bir ifade kullanın, "London" (Londra) gibi bir ifade kullanmayın. * Sokak adresi: Tam adresi girin (ör. "1600 Pennsylvania Ave NW, Washington, DC"). * Posta kodları: Ülke adıyla birlikte verilmelidir (ör. "90210, ABD" (NOT "90210"). Kullanım Modları: 1. Mevcut Hava Durumu: Yalnızca address bilgisini ver. date ve hour özelliklerini belirtmeyin. 2. Saatlik Hava Durumu Tahmini: address, date ve hour (0-23) bilgilerini verin. Belirli zamanlarda kullanın (ör. "saat 17:00'de") veya "önümüzdeki birkaç saat" ya da "bugün ilerleyen saatlerde" gibi ifadeler. Kullanıcı dakika belirtirse en yakın saate yuvarlayın. 48 saatten sonraki saatlik hava durumu tahmini desteklenmez. 3. Günlük Tahmin: address ve date bilgilerini ver. hour özelliğini belirtmeyin. Genel günlük istekler için kullanın (ö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 7 günden uzun süreli 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.
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 durumu 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ı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 |
Zorunlu. Hava durumu koşullarının alınacağı konum. |
|
|
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, önümüzdeki 7 gün içinde olmalıdır. |
|
|
hour |
İsteğe bağlıdır. İ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. Saatlik tahmin yalnızca mevcut saatten sonraki 48 saat için 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ıdır 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 olmalıdır. |
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 artı kodu. 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şaretlenmezken diğerleri 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, kaba bir konuma (ör. "Mountain View, CA") karşılık gelen serbest metinli bir adres ise farklı olabilir. |
|
|
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 maksimum ı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 ile 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ımlanır. |
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ış 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: |
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ış 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: |
Zaman damgası
| JSON gösterimi |
|---|
{ "seconds": string, "nanos": integer } |
| Alanlar | |
|---|---|
seconds |
Unix sıfır zamanı olan 1970-01-01T00:00:00Z tarihinden 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, ertesi 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, ertesi 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 isterseniz 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, sıvı su eşdeğeri olarak ölçülen yağış miktarı. 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ü temsil eden kod. |
|
|
degrees |
Rüzgarın derece cinsinden yönü (0-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 artı kodu. 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. |
Araç Ek Açıklamaları
Yok Edici İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌