"Enter"a basıp içeriğe geçin

ASP.NET Core ile Couchbase GeoSearch

Tahmini okuma süresi: 13 dakika

Bu yazının konusu Couchbase kullanarak “GeoSearch” işleminin nasıl yapılacağı olacak.

1. Couchbase Kurulumu

Bunun için aşağıdaki komutu çalıştırarak docker ile Couchbase ayağa kaldırıyoruz.

docker run -d --name couchbase -p 8091-8094:8091-8094 -p 11210:11210 couchbase

Couchbase ayağa kalktığında aşağıdaki adresten yayın yapmaya başlayacaktır.

http://localhost:8091/

“Setup New Cluster” butonuna tıklayarak cluster oluşturuyoruz. Parolayı “123456” tanımlıyoruz.

Create New Cluster
Create New Cluster

“Configure Disk, Memory, Services” butonuna tıklayarak cluster konfigürasyonuna geçiyoruz. Couchbase için memory ayırmamız gerekli. Mevcut memory durumunuza göre ayarlama yapabilirsiniz. “Analytics”i kapatabilirsiniz. “Save & Finish” butonuna tıklayarak cluster kurulumunu tamamlıyoruz.

Configure Cluster
Configure Cluster

Sol menüden “Buckets” gelip sağ üst köşeden “Add Bucket” butonuna tıklıyoruz ve “meetup” adında bucket oluşturuyoruz.

http://localhost:8091/ui/index.html#!/buckets

Add Bucket
Add Bucket

2. API’nin Oluşturulması

Örnek olarak hepimizin kullandığı Meetup uygulamasındaki etkinlikler bölümünü yapacağız. API aracılığıyla etkinlikler tanımlayacağız. Bu etkinliklerin yapılacağı konumları kaydedeceğiz. Daha sonra bulunduğumuz konuma yakın etkinliklerin listesini çekeceğiz.

ASP.NET Core API projesi oluşturuyoruz. Aşağıdaki nuget paketlerini kuruyoruz.

dotnet add package CouchbaseNetClient
dotnet add package Couchbase.Extensions.DependencyInjection

appsettings.json dosyasına Couchbase bağlantı bilgilerini ekliyoruz.

Startup.cs dosyasında Couchbase’i tanımlıyoruz.

2.1. Etkinlik Tanımlama Endpoint’in Oluşturulması

Projede “Models” adında klasör oluşturuyoruz ve içerisine “EventDocument” adında class ekliyoruz. Bu class, couchbase’deki “events” adlı bucket‘a ekleyeceğimiz dökümanın modeli olacak.

Yine aynı şekilde “Models” klasörü altına “CreateEventRequest” adında class ekliyoruz. Bu etkinliği kaydetmemizi sağlayacak olan endpoint‘in istek modeli olacak.

“EventsController” adında controller ekliyoruz.

Artık etkinlikleri Couchbase’e ekleyebiliriz. Uygulamayı çalıştıralım ve Postman’den aşağıdaki gibi istekler yapalım.

Etkinlik Oluşturma - Azure Kubernetes Service (AKS)
Etkinlik Oluşturma – Azure Kubernetes Service (AKS)
Etkinlik Oluşturma - Google Kubernetes Engine (GKE)
Etkinlik Oluşturma – Google Kubernetes Engine (GKE)
Etkinlik Oluşturma – Amazon Elastic Kubernetes Service (EKS)

Couchbase’de “events” isimli bucket‘ın dökümanlarına baktığımızda eklenmiş olduğunu göreceğiz.

http://localhost:8091/ui/index.html#!/doc_editor?bucket=events

Couchbase Event Buckets
Couchbase Event Buckets
2.2. Konuma Göre Arama Yapılmasını Sağlayan Index’in Oluşturulması

Couchbase’de sol menüden “Search”e gelip sağ üst köşeden “Add Index” butonuna tıklıyoruz.

http://localhost:8091/ui/index.html#!/fts_new/?indexType=fulltext-index&sourceType=couchbase

Name alanına “eventsgeoindex” yazıyoruz.
Bucket alanından “events”i seçiyoruz.

“Type Mappings” altında bulunan “default” isimli mapping‘in sağ tarafında bulunan “+ insert child field”ı kullanarak aşağıdaki şekilde mapping‘ler ekliyoruz.

Etkinlikteki “Subject” bilgisinin “eventsgeoindex”ine kaydedilmesi için mapping ekliyoruz.

Events Geo Index Subject Mapping
Events Geo Index Subject Mapping

Etkinlikteki “Address” bilgisinin “eventsgeoindex”ine kaydedilmesi için mapping ekliyoruz.

Events Geo Index Address Mapping
Events Geo Index Address Mapping

Etkinlikteki “Date” bilgisinin “eventsgeoindex”ine kaydedilmesi için mapping ekliyoruz.

Events Geo Index Date Mapping
Events Geo Index Date Mapping

Etkinlikteki “Location” bilgisine göre arama yapılabilmesi için mapping ekliyoruz.

 Events Geo Index Location Mapping
Events Geo Index Location Mapping

Son durum aşağıdaki görseldeki gibi olacaktır.

Events Geo Index
Events Geo Index

“Create Index” butonuna tıklayarak index’i oluşturuyoruz. “Indexing progress” 100% olduğunda index’leme bitmiş demektir.

http://localhost:8091/ui/index.html#!/fts_list?open=eventsgeoindex

2.3. Yakındaki Etkinlikleri Listeleyen Endpoint’in Oluşturulması

“Models” klasörü altına “GetUpcomingEventsRequest” adında class ekliyoruz. Bu konumumuza yakın olan etkinlikleri dönecek olan endpoint‘in istek modeli olacak.

Yine aynı şekilde “Models” klasörü altına “GetUpcomingEventsResponse” adında class ekliyoruz. Bu da konumumuza yakın olan etkinlikleri listeleyen endpoint‘in yanıt modeli olacak.

“UpcomingEventsController” adında controller ekliyoruz.
30. satırda km bazında arama yapılacağını belirtiyoruz.
40. satırda biraz sonra Couchbase’de oluşturacağımız “search index”inin adını belirtiyoruz.

Artık konumumuza yakın etkinlikleri listeyebiliriz. Uygulamayı çalıştıralım ve Postman’den aşağıdaki gibi istekler yapalım. “Radius”a 1 ve 2 yazarak 1km veya 2km yakındaki etkinlikleri görebilirsiniz.

Upcoming Events
Upcoming Events

Projenin son haline Github’dan erişebilirsiniz.

Kolay gelsin.

İlk Yorumu Siz Yapın

Bir cevap yazın

E-posta hesabınız yayımlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir