Genel Bakış

Google Map MCP ile şunlar yapılabilir:

• Adresi enlem-boylam koordinatına dönüştürme (Geocoding)
• Koordinatları adrese dönüştürme (Reverse Geocoding)
• Rota hesaplama (driving, walking, bicycling, transit)
• Belirli bir alandaki yer/mekan aramaları (Search Places)
• Mesafe ve süre hesaplama (Distance Matrix)
• Mekan detaylarını alma (Place Detail)

Distance Matrix API arka planda rotaların mesafe ve süre hesaplamasında kullanılır. MCP’de rota hesaplamaları için Google Map Directions aksiyonu kullanılır.

Configuration Manager Ayarları

1. Kuika platformuna giriş yapın.
2. Çalışacağınız projeyi seçin.

3. Configuration Manager → App Settings sekmesine gidin.
4. MCP → Google Map altında ADD NEW seçeneğini tıklayın.
5. Açılan pencerede:
   
   • Name: Ayar için isimlendirme.
   • API Key: Google Cloud Console’dan aldığınız key.

Google Map API Key Oluşturma

1. Google Cloud Console adresine gidin.

2. Var olan bir proje seçin veya yeni bir proje oluşturun.

3. Menüden APIs & Services → Library bölümüne gidin.
4. Aşağıdaki API’leri etkinleştirin:
   
   • Directions API
   • Distance Matrix API
   • Geocoding API
   • Places API
   • Places API (new)

5. Menüden APIs & Services → Credentials bölümüne gidin.

6. Create Credentials → API Key seçin.

7. Oluşan API Key’i kopyalayın.
8. Edit API Key sayfasında:

• Application restrictions:
  
  • Web için → HTTP referrer (alan adı)
  • Mobil için → Android package name / iOS bundle ID
  • Server için → IP kısıtlaması
  • None → Kısıtlama yok
• API restrictions: Yalnızca yukarıdaki etkinleştirdiğiniz API’lere izin verin.

9. Save ile kaydedin.

10.  API Key’i Kuika’daki Configuration Manager → Google Map Settings alanına ekleyin.

Action Türleri

Google Map Get Geocode

Adresi koordinata dönüştürür.

Input:

• settings: Config Manager’da oluşturulan Google Map ayarı seçilir.
• address (String): Kullanıcı tarafından girilen okunabilir adres. (Örn: "İstiklal Caddesi, Beyoğlu, İstanbul")

Output:

• location.lat, location.lng: Enlem-boylam koordinatları.
• formatted_address: Google tarafından standartlaştırılmış tam adres.
• place_id: Google Maps üzerindeki benzersiz kimlik.

Google Map Place Detail

Belirli bir place_id bilgisinin detaylarını getirir.

Input:

• settings: Configuration Manager’da oluşturulan Google Map ayarı seçilir.
  
• place_id (String): Mekanın benzersiz kimliği. (Get Geocode veya Search Places sonucunda elde edilir.)

Output:

• name: Mekan/işletme adı.
• location.lat, location.lng: Enlem-boylam koordinatları.
• formatted_address: Standartlaştırılmış adres.

Google Map Reverse Geocode

Koordinatı adrese dönüştürür.

Input:

• settings: Config Manager’da oluşturulan Google Map ayarı seçilir.
• latitude (Decimal): Enlem değeri.
• longitude (Decimal): Boylam değeri.

Output:

• formatted_address: Tam adres bilgisi.
• place_id: Benzersiz kimlik.
• address_components: Adresin alt bileşenleri (sokak, şehir, ülke, posta kodu).
  
  • long_name: Bileşenin tam açıklaması.
  • short_name: Standart kısaltma.
  • types: Bileşenin türü (örn: route, locality, country).

Google Map Search Places

Belirli bir alandaki mekanları arar.

Input:

• settings: Configuration Manager’da oluşturulan Google Map ayarı seçilir.
• query (String): Yer adı/kategori (örn: "cafe", "hotel")
• radius (Integer): Arama merkezinden maksimum mesafe (metre cinsinden).
• latitude (Decimal): Enlem değeri.
• longitude (Decimal): Boylam değeri.

Output:

• name: Mekan adı.
• formatted_address: Tam adres.
• location.lat, location.lng: Koordinatlar.
• place_id: Benzersiz kimlik.
• rating (Decimal): Kullanıcı puanı (1.0–5.0).
• types: Kategoriler (örn: "restaurant", "museum").

Google Map Directions

‍

İki nokta arasındaki mesafe ve süreyi hesaplar.

Input:

• settings: Config Manager’da oluşturulan Google Map ayarı seçilir.
• origin (String/lat,lng): Başlangıç noktası.
• destination (String/lat,lng): Varış noktası.
• mode (String): Ulaşım modu.
  
  • driving → Araç
  • walking → Yürüyerek
  • bicycling → Bisiklet
  • transit → Toplu taşıma

Output:

‍

• summary: Rotanın genel açıklaması.
• distance.text / distance.value: Toplam mesafe (örn: "14.3 km", 14300).
• duration.text / duration.value: Tahmini süre (örn: "20 mins", 1200).
• steps: Her adım için detaylı bilgi.
  
  • instructions: HTML formatlı yön tarifi.
  • travel_mode: Kullanılan ulaşım modu.

Google Map Distance Matrix

Input

• settings: Config Manager’da oluşturulan Google Map ayarı seçilir.
• origin (String/lat,lng): Başlangıç noktası.
• destination (String/lat,lng): Varış noktası.
• mode (String): Ulaşım modu (driving, walking, bicycling, transit).

Output

• destination_addresses: Hedef adreslerin formatlı hali.
• origin_addresses: Başlangıç adreslerinin formatlı hali.
• results: Her origin–destination kombinasyonu için detay.
  
  • distance: Metin ve metre cinsinden mesafe.
  • duration: Metin ve saniye cinsinden süre.
  • status: Sonuç durumu (OK, ZERO_RESULTS, vb.).

Kuika’da Kullanım Senaryoları

• Kullanıcıdan adres alıp koordinata çevirme → Get Geocode
• Haritada tıklanan noktayı adrese çevirme → Reverse Geocode
• “Yakınımdaki kafeleri bul” → Search Places
• İki adres arasındaki en hızlı rotayı gösterme → Distance Matrix
• İki nokta arasındaki ayrıntılı rota adımlarını ve yön tariflerini alma → Google Map Directions‍
• Bir mekanın detaylarını alma (ör: puanı, adresi) → Place Detail