search_places |
Kullanıcı yer, işletme, adres, konum, önemli yer veya Google Haritalar ile ilgili başka bir arama yapmak istediğinde bu aracı çağırın. Giriş Şartları (KRİTİK):
text_query (dize - ZORUNLU): Birincil arama sorgusu. Bu, kullanıcının ne aradığını net bir şekilde tanımlamalıdır.
- Örnekler:
'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
- Belirli yer ayrıntıları için: İstenen özelliği (ör.
'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address') ekleyin.
location_bias (nesne - İSTEĞE BAĞLI): Belirli bir coğrafi bölgenin yakınındaki sonuçlara öncelik vermek için bunu kullanın.
- Biçim:
{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- Kullanım:
- 5 km'lik bir yarıçapa yönlendirmek için:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
- Merkez noktaya güçlü bir şekilde yönlendirmek için:
{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters hariç).
language_code (dize - İSTEĞE BAĞLI): Arama sonuçları özetinin gösterileceği dil.
- Biçim: İki harfli bir dil kodu (ISO 639-1) ve isteğe bağlı olarak bir alt çizgi ve iki harfli bir ülke kodu (ISO 3166-1 alfa-2) (ör.
en, ja, en_US, zh_CN, es_MX). Dil kodu sağlanmazsa sonuçlar İngilizce olur.
region_code (dize - İSTEĞE BAĞLI): Kullanıcının Unicode CLDR bölge kodu. Bu parametre, varsa bölgeye özgü yer adı gibi yer ayrıntılarını göstermek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir.
- Biçim: İki harfli ülke kodu (ISO 3166-1 alfa-2), ör.
US, CA.
Araç Çağrısı Talimatları:
Konum Bilgisi (KRİTİK): Aramada yeterli konum bilgisi bulunmalıdır. Konum belirsizse (ör. yalnızca "pizzacılar") text_query parametresinde belirtmeniz (ör. "New York'taki pizzacılar") veya location_bias parametresini kullanmanız gerekir. Anlam belirsizliğini gidermek için gerekirse şehir, eyalet/il ve bölge/ülke adını ekleyin. Her zaman mümkün olan en spesifik ve bağlam açısından zengin text_query kullanın. location_bias aracını yalnızca koordinatlar açıkça belirtilmişse veya kullanıcının bilinen bağlamından konum çıkarımı yapmak uygunsa ve daha iyi sonuçlar için gerekliyse kullanın.
Temellendirilmiş çıkış, mümkün olduğunda attribution alanındaki bilgiler kullanılarak kaynağa atfedilmelidir.
|
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.
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
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 (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ı:
|
compute_routes |
Başlangıç ve varış noktası arasında (isteğe bağlı olarak ara duraklar üzerinden) seyahat rotalarını hesaplar. Her rotanın mesafesini ve süresini döndürür. Giriş Şartları (KRİTİK):
origin ve destination (nesneler - ZORUNLU): Her biri, aşağıdakilerden tam olarak biri kullanılarak sağlanmalıdır:
address (dize, ör. 'Eiffel Tower, Paris'). Adlandırılmış yerler, önemli noktalar ve işletmeler doğrudan çözümlenir. Bu nedenle, yalnızca bir ara noktanın coğrafi kodunu almak için önce search_places yöntemini çağırmayın. Kullanıcının bahsettiği şehir, bölge veya ülkeleri ekleyin.lat_lng (nesne, {"latitude": number, "longitude": number}).place_id (dize, ör. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), örneğin search_places. intermediate_waypoints (nesne dizisi - İSTEĞE BAĞLI): Başlangıç ve varış noktası arasında sırayla geçilecek en fazla 10 durak. origin ile aynı biçim. TRANSIT ile desteklenmez. Yalnızca kullanıcının istediği durakları ekleyin.
travel_mode (enum - İSTEĞE BAĞLI): DRIVE (varsayılan), WALK, BICYCLE veya TRANSIT.
Zamanlama (İSTEĞE BAĞLI - en fazla BİR tane ayarlayın): UTC farkı içeren RFC 3339 zaman damgaları (ör. '2026-09-19T08:00:00-07:00'). Varsayılan olarak "Şimdi hareket ediyor" seçeneği kullanılır. TRANSIT için zaman, geçmişte en fazla 7 gün veya gelecekte en fazla 100 gün olabilir. Diğer modlarda ise zaman, gelecekte 365 güne kadar olabilir ve geçmişte olmamalıdır.
departure_time: Kullanıcı ne zaman ayrılacağını söylediğinde (ör. "yarın sabah 8'de") kullanın.arrival_time: Kullanıcı ne zaman varması gerektiğini söylediğinde (ör. "saat 09:00'da orada ol") kullanılır. routing_preference (enum - İSTEĞE BAĞLI):
ROUTING_PREFERENCE_TRAFFIC_UNAWARE (varsayılan): Canlı trafik, olaylar ve kapalı yollar yok sayılır. En düşük gecikme.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: Mümkün olduğunda canlı trafik koşullarını kullanır. WALK veya BICYCLE için desteklenmez. Bu ayarı YALNIZCA kullanıcı trafik, yoğunluk veya trafiğe göre ayarlanmış TVS hakkında soru sorduğunda kullanın. Daha yüksek maliyet ve gecikmeye neden olur. location_bias (nesne - İSTEĞE BAĞLI): Ara nokta adreslerindeki yer adlarının anlam belirsizliğini gidermek için kullanılan {"latitude": number, "longitude": number}. Ad belirsizse (ör. "Springfield") ve kullanıcı bölge belirtmediyse adı address içinde verildiği gibi bırakın ve bölgeyi tahmin etmek yerine location_bias değerini amaçlanan alana ayarlayın.
compute_alternative_routes (boole - İSTEĞE BAĞLI): Yalnızca kullanıcı rota seçenekleri veya alternatifleri istediğinde true olarak ayarlayın. Varsayılan değer false olup yalnızca önerilen rotayı döndürür.
include_polyline (boolean - İSTEĞE BAĞLI): Yalnızca rota geometrisi (encoded_polyline) gerektiğinde true olarak ayarlanır. Varsayılan değer: false.
Araç Çağrısı Talimatları:
- Başlangıç veya hedef eksikse aracı çağırmadan önce kullanıcıdan açıklama istemeniz ZORUNLUDUR.
- "A, B'den ne kadar uzakta?" soruları için B'yi
origin, A'yı ise destination olarak kullanın.
Örnek Araç Çağrısı: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"} Instructions for Response:
- Alternatif rotalar istendiğinde rotalar en çok önerilenden en az önerilene doğru sıralanır.
routes boşsa kullanıcıya rota bulunamadığını söyleyin. Rotayı tahmin etmeyin.- Yalnızca araç tarafından döndürülen gerçekleri belirtin. Adım adım yol tarifleri, toplu taşıma hatları, istasyonlar, peronlar veya aktarmalar uydurmayın.
- Temellendirilmiş çıkış, mümkün olduğunda her rotanın
attribution alanı kullanılarak kaynağa atfedilmelidir.
|
resolve_names |
Belirli konum sorgularının (yer işareti adları veya tam adresler) toplu listesini standart Google Haritalar yer kimliklerine dönüştürür. Giriş Şartları (KRİTİK):
queries (nesne dizisi - ZORUNLU): Çözümlenecek konum sorgularının listesi. En fazla 20 sorgu belirtebilirsiniz.
- Her sorgu nesnesinde şunlar bulunmalıdır:
text (dize - ZORUNLU): Çözümlenecek belirli bir yer adını veya adresi temsil eden metin sorgusu.
- Örnekler:
'Googleplex, Mountain View, CA', '1600 Amphitheatre Pkwy, Mountain View, CA', 'Eiffel Tower, Paris'.
location_bias (nesne - İSTEĞE BAĞLI): Belirli bir coğrafi bölgenin yakınındaki sonuçlara öncelik vermek için bunu kullanın.
- Biçim:
{"viewport": {"low": {"latitude": [value], "longitude": [value]}, "high": {"latitude": [value], "longitude": [value]}}}
region_code (dize - İSTEĞE BAĞLI): Sonuçları etkilemek için kullanıcının Unicode CLDR bölge kodu (iki harfli ülke kodu, ör. US, CA).
Araç Çağrısı Talimatları:
- Özgüllük (KRİTİK): Sorgular belirli bir yer adını veya adresi temsil etmelidir.
'restaurants' gibi genel aramalar veya 'Starbucks' gibi zincir adları desteklenmez.
- Çağırmayı planladığınız alt araçlar ham adres veya yer adı dizelerini doğrudan kabul ediyorsa bu aracı KULLANMAYIN.
Google Haritalar'a kaydetme:
- Yanıt, başarıyla çözümlenen tüm yerleri içeren tek bir Google Haritalar bağlantısı olan
save_to_maps_url alanını içerir.
- Kullanıcı, çözümlenen yerleri Google Haritalar'da liste olarak kaydetmek, paylaşmak veya açmak istediğinde bu bağlantıyı kullanıcıya gösterin. Bu bağlantıyı kendiniz OLUŞTURMAYIN.
Hata İşleme (KRİTİK):
- Bu bir toplu işleme aracıdır. Bir istek "karışık sonuçlar" döndürebilir (ör. bazı sorgular başarıyla çözülürken diğerleri başarısız olur).
results çıkış listesinin, giriş queries dizinleriyle 1:1 eşleşmesi garanti edilir. Başarısız bir sorgu, results listesindeki ilgili dizinde boş bir Result mesajı (entity ayarlanmamış) döndürür.- Hangi sorgu dizininin başarısız olduğunu belirlemek için yanıttaki
failed_requests eşleme alanını kontrol etmeniz GEREKİR. failed_requests anahtarı, istekteki başarısız sorgunun 0 tabanlı dizinini temsil eder. Kısmi bir hata nedeniyle toplu çağrının tamamının başarısız olduğunu varsaymayın.
|
resolve_maps_urls |
Google Haritalar URL'lerinin listesini standart Google Haritalar yer kimliklerine dönüştürür. Bu aracın ne zaman çağrılacağı (KRİTİK):
- Kullanıcı bir veya daha fazla Google Haritalar paylaşım bağlantısı ya da URL'si (ör. "https://maps.app.goo.gl/...", "https://www.google.com/maps/place/..." veya "https://maps.google.com/...") ve temel standart yer kimliklerini ayıklamanız gerekir.
- Tek bir toplu istekte çözümlenecek en fazla 20 URL belirtebilirsiniz.
Giriş Şartları (KRİTİK):
urls (dize dizisi - ZORUNLU): Çözümlenecek Google Haritalar URL'lerinin listesi. Her URL, geçerli ve tek bir yeri gösteren Google Haritalar URL'si olmalıdır. Google Haritalar'a kaydetme:
- Yanıt, başarıyla çözümlenen tüm yerleri içeren tek bir Google Haritalar bağlantısı olan
save_to_maps_url alanını içerir.
- Kullanıcı, çözümlenen yerleri Google Haritalar'da liste olarak kaydetmek, paylaşmak veya açmak istediğinde (ör. bir görüşmede paylaşılan yerleri toplamak) bu bağlantıyı kullanıcıya gösterin. Bu bağlantıyı kendiniz OLUŞTURMAYIN.
Hata İşleme (KRİTİK):
- Bu bir toplu işleme aracıdır. Bir istek "karışık sonuçlar" döndürebilir (ör. bazı URL'ler başarıyla çözümlenirken diğerleri başarısız olur).
entities çıkış listesinin, giriş urls dizinleriyle 1:1 eşleşmesi garanti edilir. URL çözümleme işlemi başarısız olursa entities listesindeki ilgili dizinde boş bir Entity mesajı (hiçbir alan ayarlanmaz) gösterilir.- Hangi URL dizininin başarısız olduğunu belirlemek için yanıttaki
failed_requests harita alanını kontrol etmeniz ZORUNLUDUR. failed_requests anahtarı, istekteki başarısız URL'nin 0 tabanlı dizinini temsil eder. Kısmi bir hata nedeniyle toplu çağrının tamamının başarısız olduğunu varsaymayın.
|
