Site Kit-Geocoding Api ile Retrofit Kullanımı
Merhabalar,
Bu yazımda sizlere Huawei Site Kit’in Geocoding api’sinden söz edip, retrofit ile nasıl kullanılacağından bahsedeceğim.
Geocoding API
Site Kit, geocoding işlemlerini kolayca geliştirebileceğiniz bir dizi HTTP API’si sağlar. Uygulamanız API’leri çağırdığında, ilgili veriler JSON formatında yanıtlarla dönecektir.
Forward Geocoding: Adresini aldığı bir yerin uzamsal koordinatlarını (örneğin boylam ve enlem) verir. Maksimum 10 kayıt iade edilebilir.
Reverse Geocoding: Parametre olarak verilen enlem ve boylama bağlı olarak cihaz konumunun 200 metre çevresinde yer alan bir yerin ayrıntılı adresini alır. Maksimum 11 kayıt döndürülebilir.
Ben bu yazımda Reverse Geocoding için bir use case oluşturacağım.
Entegrasyon
1-İlk olarak developer hesabı açılmalı ve HMS Core’u projeye entegre etmeliyiz.Bu process’e aşağıdaki bağlantıdan erişebilirsiniz.
2-İlk olarak app-level build-gradle dosyasına aşağıdaki bağımlılığı ekleyelim.
3-Retrofit kullanacağımız için Request ve Response modellerimizi oluşturalım.
Şimdi de retrofit client’ı oluşturalım.
Sonrasında post isteği atacağımız interface’i oluşturmamız gerekiyor.Burada api key kullanıyoruz.Api key’e app gallery console’da proje settings içerisinden bakabilirsiniz.Api key’i kullanırken encode edip kullanmamız gerekiyor.Aşağıdaki şekilde encode edebilirsiniz. Detaylı bilgiye buradan ulaşabilirsiniz.
Sonrasında activity içerisinde post isteğimizi yaparak result’ı istediğimiz şekilde kullanabiliriz. Burada dikkat edilmesi gereken şey önce longtitude gönderilmesi.
Burada verdiğimiz LatLng parametrelerinin reverse geocoding yöntemiyle handle edilmesinden sonra dönen sonuç bu şekilde. Result’ı istediğiniz şekilde kullanabilirsiniz.
Eğer adres verip location almak isterseniz o zaman forward geocoding kullanmalısınız.
Keyifli okumalar :)
Referanslar