w3w swift components

w3w-swift-komponen

Ringkasan

Pustaka Swift untuk komponen UI What3words. Paket Komponen Swift ini menyediakan cara mudah untuk menambahkan fungsionalitas antarmuka kata apa pada aplikasi Anda seperti bidang teks saran otomatis, tampilan peta, atau garis kisi kata apa ke dalam aplikasi Anda.

Ini termasuk:

• Komponen Saran Otomatis tersedia sebagai UITextField, atau UISearchController
• Komponen Peta menyediakan cara mudah untuk menyertakan kotak What3words di MKMapView Anda, atau pengontrol tampilan peta berfitur lengkap.

Catatan

• Komponen ini berfungsi dengan iOS 12.0 atau lebih tinggi.
• Paket ini bergantung pada pembungkus Swift What3words dan inti Swift.
• Jika Anda meningkatkan versi dari versi 1.xx mana pun, lihat panduan peningkatan.

Instalasi

Otentikasi

Untuk menggunakan perpustakaan ini, Anda memerlukan kunci API what3words, yang dapat didaftarkan di sini. Jika Anda ingin menggunakan panggilan Voice API maka Anda harus menambahkan paket Voice API ke akun Anda.

Manajer Paket Swift

Anda dapat menginstal dengan Swift Package Manager dengan menambahkan URL di bawah ini ke Paket Swift di bawah pengaturan proyek Anda:

 https://github.com/what3words/w3w-swift-components.git

Impor perpustakaan:

import W3WSwiftApi
import W3WSwiftComponents
import CoreLocation

Catatan:

Jika Anda menggunakan API Suara di perangkat, Anda harus menyertakan izin Mikrofon di Info.plist Anda:

Komponen

Bidang Teks Saran Otomatis

W3WAutoSuggestTextField adalah UITextField yang akan menyarankan tiga alamat kata saat pengguna memasukkan teks. Secara opsional, ada opsi pengenalan suara.

Ini sesuai dengan W3WAutoSuggestTextFieldProtocol kami. Dengan demikian, antarmuka didokumentasikan di Documentation/Autosuggest/autosuggest.md.

---

Pengontrol Pencarian Saran Otomatis

W3WAutoSuggestSearchController adalah UISearchController yang akan menyarankan tiga alamat kata saat pengguna memasukkan teks. Hal ini memungkinkan penyematan fungsi ini dalam hal-hal seperti UINavigationController . Secara opsional, ada opsi pengenalan suara.

Ini sesuai dengan W3WAutoSuggestTextFieldProtocol kami. Dengan demikian, antarmuka didokumentasikan di Documentation/Autosuggest/autosuggest.md.

Pembantu Peta

Map Helper memungkinkan Anda dengan mudah mengintegrasikan fitur peta What3words ke dalam peta yang sudah ada.

W3WMapHelper sesuai dengan W3WMapViewProtocol . Referensi fungsinya dapat ditemukan di Documentation/Map/map.md

 let api = What3WordsV4(apiKey: "YourApiKey")
let mapHelper = W3WMapHelper(api, map: yourMKMapView)

Jika aplikasi Anda sudah memiliki ViewController yang memiliki peta, W3WMapHelper menyediakan fungsi praktis untuk ditambahkan ke fungsi MKMapViewDelegate agar anotasi kisi dan pin What3words muncul di peta Anda. Contoh yang ditautkan di atas menunjukkan di mana Anda akan melakukan panggilan, dan cara membuat instance W3WMapHelper .

Tampilan Peta

W3WMapView sesuai dengan W3WMapViewProtocol . Referensi fungsinya dapat ditemukan di Documentation/Map/map.md

 let api = What3WordsV4(apiKey: "YourApiKey")
let mapview = W3WMapView(api)

Kami menciptakan W3WMapView sebagai cara cepat dan kotor untuk segera memasukkan fungsionalitas What3words ke dalam aplikasi Anda.

Cukup ganti MKMapView Anda dengan W3WMapView, dan aplikasi Anda akan berperilaku sama seperti sebelumnya kecuali aplikasi tersebut akan menggambar garis kisi what3words, dan memiliki beberapa fungsi baru yang tersedia, seperti addMarker(at: "filled.count.soap") .

Ini berasal dari MKMapView tetapi Apple tidak menyarankan untuk menurunkan objek baru dari MKMapView mungkin karena antarmukanya dapat berubah di masa depan, jadi lihat ini sebagai cara cepat dan kotor untuk memasukkan fungsionalitas ke dalam aplikasi Anda.

Pendekatan yang lebih baik adalah dengan menggunakan W3WMapHelper yang dirancang agar sesuai dengan kelas penyesuaian MKMapViewDelegate Anda, mungkin UIViewController .

Komponen Peta

W3WMapViewController sesuai dengan W3WMapViewProtocol . Referensi fungsinya dapat ditemukan di Documentation/Map/map.md

 let api = What3WordsV4(apiKey: "YourApiKey")
let vc = W3WMapViewController(api)

Ini menunjukkan W3WMapViewController yang merupakan komponen tingkat tinggi yang memiliki fungsionalitas What3words yang mudah digunakan.

Jika Anda tidak memiliki peta di aplikasi Anda dan ingin segera menyertakan peta dengan beberapa perilaku default, maka ini mungkin cocok untuk Anda.

Pengaturan

Pengukuran

Sistem pengukuran dalam komponen ini diatur ke preferensi atau lokal pengguna secara otomatis, namun Anda dapat menggantinya menjadi .metric , atau .imperial :

 W3WSettings . measurement = . metric

Lokalisasi

Komponen W3WAutosuggest telah diterjemahkan ke dalam sekitar 50 bahasa, dan file Localizable.strings untuk komponen ini ada di Sumber Daya paket ini. Agar dapat berfungsi, seperti pengaturan pelokalan iOS lainnya, pastikan untuk menambahkan bahasa yang ingin Anda gunakan dalam pengaturan proyek Anda di bawah Info -> Localizations .