Google Haritalar ve Drive ile Adres Doğrulama ve Sokak Görünümü Görüntüsü Oluşturma

Genel Bakış

Bu n8n iş akışı, kullanıcıların Google Haritalar API'lerini kullanarak adresleri doğrulamalarını ve ilgili Sokak Görünümü görüntülerini otomatik olarak oluşturmalarını sağlar. Süreç, basit bir form girişiyle başlar, Google Geocoding API aracılığıyla adresin coğrafi koordinatlarını elde eder ve ardından bu koordinatlara dayanarak Google Street View Static API'den bir görüntü talep eder. Elde edilen görüntü, Google Drive'a kaydedilir ve kullanıcıya dinamik bir HTML çıktısı ile sunularak görsel bir doğrulama ve arşivleme çözümü sunar. Özellikle adres tabanlı operasyonları olan işletmeler için veri doğruluğunu artırırken manuel işlemleri azaltır ve görsel kanıt sağlar.

Gereksinimler

Bu iş akışını başarıyla kurmak ve çalıştırmak için aşağıdaki hesaplara ve API anahtarlarına ihtiyacınız olacaktır:

• n8n Hesabı: İş akışını barındırmak ve çalıştırmak için bir n8n kurulumu (cloud veya self-hosted).
• Google Cloud Platform Hesabı: Google Haritalar API'lerini kullanmak için bir Google Cloud hesabı gereklidir.
• Google Haritalar API Anahtarı: Google Geocoding API ve Street View Static API'yi etkinleştirmeniz ve bir API anahtarı oluşturmanız gerekmektedir. Bu anahtarın uygun kısıtlamalara sahip olduğundan emin olun (HTTP referer veya IP kısıtlamaları).
• Google Drive Hesabı: Oluşturulan Street View görüntüsünü kaydetmek için bir Google Drive hesabına ihtiyacınız olacaktır.
• n8n Google Drive Kimlik Bilgileri: n8n içerisinde Google Drive'a bağlanmak için OAuth2 kimlik bilgileri oluşturmanız gerekecektir.

Kurulum Adımları

Bu iş akışını n8n ortamınıza kurmak için aşağıdaki adımları izleyin:

1. İş Akışını İçe Aktarma: Sağlanan JSON iş akışı tanımını n8n ortamınıza içe aktarın. Bunu n8n arayüzünde 'New Workflow' -> 'Import from JSON' seçeneğini kullanarak yapabilirsiniz.

2. Form Trigger Düğümünü Yapılandırma: İş akışının başlangıcı olan 'Form Trigger' düğümünü açın. Bu düğüm, kullanıcılardan adres girişi almak için bir web formu oluşturur. Varsayılan ayarlar genellikle yeterlidir, ancak form alanlarını veya mesajlarını özelleştirebilirsiniz.

3. Set Düğümünü Yapılandırma: 'Set' düğümü, Google Haritalar API anahtarınızı dinamik olarak ayarlamak için kullanılır. Bu düğümde, googleMapsApiKey adında yeni bir ifade ekleyin ve değer olarak Google Haritalar API anahtarınızı tırnak içinde girin. Örneğin: "YOUR_GOOGLE_MAPS_API_KEY". Bu, API anahtarınızın iş akışının geri kalanında kullanılabilir olmasını sağlar.

4. Geocoding HTTP Request Düğümünü Yapılandırma: 'HTTP Request' düğümlerinden ilki, Google Geocoding API'ye adres doğrulama isteği gönderir. Bu düğümün URL'sinin doğru olduğundan ve address parametresinin 'Form Trigger' düğümünden gelen adres değerini kullandığından emin olun. API anahtarınızın key parametresi olarak eklendiğinden emin olun (Set düğümünden gelen değeri kullanabilirsiniz).

5. If Düğümünü Yapılandırma: 'If' düğümü, Geocoding API'den başarılı bir yanıt gelip gelmediğini ve koordinatların mevcut olup olmadığını kontrol eder. Koşulların, yanıtın status alanının 'OK' olup olmadığını ve results[0].geometry.location alanının varlığını kontrol ettiğinden emin olun.

6. Street View HTTP Request Düğümünü Yapılandırma: 'If' düğümünün 'True' dalındaki 'HTTP Request' düğümü, Google Street View Static API'den bir görüntü talep eder. Bu düğümün URL'sinin doğru olduğundan ve location parametresinin Geocoding API'den gelen enlem ve boylam değerlerini kullandığından emin olun. size ve heading gibi diğer parametreleri ihtiyacınıza göre ayarlayabilirsiniz. API anahtarınızın key parametresi olarak eklendiğinden emin olun.

7. Google Drive Düğümünü Yapılandırma: 'Google Drive' düğümü, oluşturulan Street View görüntüsünü Google Drive hesabınıza kaydeder. Bu düğümü yapılandırmak için:

   • Kimlik Bilgileri: Daha önce n8n'de oluşturduğunuz Google Drive OAuth2 kimlik bilgilerini seçin. Eğer yoksa, yeni bir kimlik bilgisi oluşturmanız gerekecektir.
   • İşlem: 'Upload' olarak ayarlandığından emin olun.
   • Dosya Adı: Görüntü için benzersiz ve açıklayıcı bir dosya adı belirleyin (örn. {{ $('HTTP Request1').item.json.address.replace(/\s/g, '_') }}_StreetView.jpg).
   • Dosya İçeriği: Street View HTTP isteğinden gelen ikili veriyi kullanın (genellikle data veya response alanında bulunur).
   • Hedef Klasör: Görüntülerin kaydedileceği Google Drive klasörünün kimliğini veya yolunu belirtin.

8. HTML Düğümünü Yapılandırma: 'HTML' düğümü, kullanıcıya Street View görüntüsünü ve diğer ilgili bilgileri gösteren dinamik bir HTML sayfası oluşturur. Bu düğümün içeriğini, Google Drive'a yüklenen görüntünün bağlantısını ve adres bilgilerini içerecek şekilde özelleştirin.

9. İş Akışını Etkinleştirme: Tüm düğümleri doğru şekilde yapılandırdıktan sonra, iş akışını etkinleştirin ('Activate' düğmesine tıklayın). Artık 'Form Trigger' düğümünün sağladığı URL'yi kullanarak iş akışını test edebilirsiniz.

Gerçek Dünya Kullanım Senaryoları

• Emlak Sektörü: Potansiyel alıcılara veya kiracılara bir mülkün dış görünüşünü hızlıca göstermek ve adres doğruluğunu teyit etmek.
• Lojistik ve Teslimat: Teslimat rotalarını planlarken veya yeni bir teslimat noktası eklerken adresin fiziksel ortamını görsel olarak incelemek.
• Şehir Planlama ve Altyapı: Yeni projeler için saha araştırması yapmadan önce mevcut durumu değerlendirmek veya belediye hizmetleri için adres verilerini doğrulamak.
• Sigorta Değerlendirmesi: Hasar tespiti veya poliçe oluşturma süreçlerinde bir mülkün dış görünüşünü kaydetmek ve doğrulamak.
• Coğrafi Bilgi Sistemleri (CBS) Veri Zenginleştirme: Mevcut adres veritabanlarına Street View görüntüleri ekleyerek görsel bağlam sağlamak.

İpuçları ve En İyi Uygulamalar

• API Anahtarı Güvenliği: Google Haritalar API anahtarınızı asla doğrudan koda gömmeyin. n8n'in kimlik bilgileri özelliğini veya 'Set' düğümünü kullanarak güvenli bir şekilde yönetin ve API anahtarınıza HTTP referer veya IP kısıtlamaları uygulayın.
• Hata Yönetimi: İş akışınıza 'Try/Catch' düğümleri ekleyerek API isteklerinin başarısız olması durumunda gracefully hata yönetimi sağlayın. Örneğin, Street View görüntüsü bulunamazsa alternatif bir mesaj gösterin.
• Performans Optimizasyonu: Büyük ölçekli kullanımlarda, API isteklerini toplu işlemeye veya önbelleğe almaya çalışın. Google Haritalar API'lerinin kullanım limitlerini ve maliyetlerini göz önünde bulundurun.
• Dinamik Dosya Adları: Google Drive'a yüklenen dosyalar için dinamik ve açıklayıcı adlar kullanın. Bu, dosyaları daha sonra bulmayı ve yönetmeyi kolaylaştırır.
• Kullanıcı Geri Bildirimi: HTML çıktısını, kullanıcının girdiği adresin doğrulanıp doğrulanmadığı, görüntünün başarıyla oluşturulup oluşturulmadığı gibi net geri bildirimler içerecek şekilde tasarlayın.
• Modülerlik: İş akışının belirli bölümlerini (örneğin, API çağrıları) ayrı alt iş akışlarına ayırarak okunabilirliği ve bakımı artırın.
• Günlük Kaydı: Önemli adımlarda veya hata durumlarında n8n'in günlük kaydı özelliklerini kullanarak sorun gidermeyi kolaylaştırın.

Sık Sorulan Sorular

S: Google Haritalar API anahtarımı nasıl alabilirim? Y: Google Cloud Platform konsolunuza gidin, 'API'ler ve Hizmetler' bölümünden 'Kimlik Bilgileri'ni seçin ve yeni bir API anahtarı oluşturun. Ardından 'Google Geocoding API' ve 'Street View Static API'yi etkinleştirmeniz gerekecektir.

S: Neden Street View görüntüsü oluşturulamıyor? Y: Bunun birkaç nedeni olabilir: Adres geçersiz olabilir, Street View verileri o konum için mevcut olmayabilir, API anahtarınızda kısıtlamalar olabilir veya API kullanım limitlerinize ulaşmış olabilirsiniz. n8n'deki HTTP Request düğümünün çıktısını kontrol ederek hata mesajlarını inceleyin.

S: Google Drive'a kaydetmek yerine görüntüyü doğrudan kullanıcıya nasıl gösterebilirim? Y: Google Drive düğümünü atlayabilir ve Street View HTTP Request düğümünden gelen ikili veriyi doğrudan bir 'HTML' düğümünde data:image/jpeg;base64,... formatında bir img etiketi içinde gösterebilirsiniz. Ancak bu, görüntüyü kalıcı olarak kaydetmez.

S: İş akışını belirli bir coğrafi bölgeyle sınırlayabilir miyim? Y: Evet, Geocoding API isteğine region veya components parametreleri ekleyerek adres doğrulamasını belirli bir ülke veya bölgeyle sınırlayabilirsiniz. Street View için ise location parametresi doğrudan koordinatları kullandığından, bu kısıtlama Geocoding adımında yapılmalıdır.

Bu rehber Otomasyonevi.com tarafından hazırlanmıştır.