w3w python wrapper
v3.3.0
Perpustakaan Python untuk menggunakan What3Words Rest API.
Diuji dengan Python 2.7, 3.4, 3.5, 3.6 (periksa travis-ci.org build)
Perpustakaan Python What3Words memberi Anda akses terprogram ke
Untuk menggunakan perpustakaan ini, Anda akan memerlukan kunci API, silakan kunjungi https://what3words.com/select-plan dan daftar untuk akun.
Untuk menginstal what3words, cukup:
$ pip install what3wordsMenginstal versi terbaru dari GitHub:
$ git clone https://github.com/what3words/w3w-python-wrapper.git
$ cd w3w-python-wrapper
$ python setup.py install Fungsi ini mengambil parameter kata sebagai string 3 kata 'table.book.chair'
Muatan yang dikembalikan dari metode convert-to-coordinates dijelaskan dalam dokumentasi API What3Words REST.
Fungsi ini membutuhkan garis lintang dan bujur:
lat=0.1234 , lng=1.5678 Payload yang dikembalikan dari metode convert-to-3wa dijelaskan dalam dokumentasi API What3Words REST.
Mengembalikan daftar 3 alamat kata berdasarkan input pengguna dan parameter lainnya.
Metode ini memberikan koreksi untuk jenis kesalahan input berikut:
Metode autosuggest menentukan kemungkinan koreksi untuk string 3 alamat kata yang disediakan berdasarkan probabilitas kesalahan input yang tercantum di atas dan mengembalikan daftar saran peringkat. Metode ini juga dapat mempertimbangkan kedekatan geografis dari kemungkinan koreksi ke lokasi tertentu untuk lebih meningkatkan saran yang dikembalikan.
Anda hanya akan menerima hasil kembali jika string alamat 3 kata parsial yang Anda kirim berisi dua kata pertama dan setidaknya karakter pertama dari kata ketiga; jika tidak, pesan kesalahan akan dikembalikan.
Kami memberikan berbagai kebijakan clip untuk memungkinkan Anda menentukan area geografis yang digunakan untuk mengecualikan hasil yang tidak mungkin relevan bagi pengguna Anda. Kami menyarankan Anda menggunakan parameter clip untuk memberikan hasil yang lebih bertarget dan lebih pendek kepada pengguna Anda. Jika Anda tahu lokasi pengguna saat ini, kami juga sangat menyarankan Anda menggunakan focus untuk mengembalikan hasil yang cenderung lebih relevan.
Singkatnya, kebijakan clip digunakan untuk secara opsional membatasi daftar hasil kandidat autosuggest, setelah itu, jika fokus telah disediakan, ini akan digunakan untuk memberi peringkat hasil dalam urutan relevansi dengan fokus.
https://docs.what3words.com/api/v3/#autosuggest
Payload yang dikembalikan dari metode autosuggest dijelaskan dalam dokumentasi API What3Words REST.
Mengembalikan bagian dari kisi 3m x 3m What3words untuk kotak pembatas.
Mengambil daftar bahasa alamat 3 kata yang saat ini dimuat dan tersedia.
Payload yang dikembalikan dari metode available-languages dijelaskan dalam dokumentasi API What3Words REST.
Metode ini mengambil string sebagai parameter dan mengembalikan apakah string dalam format 3WA (misalnya "diisi.count.soap"). Jenis pengembalian adalah Boolean. Catatan: Tidak memeriksa apakah itu 3WA yang ada.
isPossible3wa(“filled.count.soap”) returns True
isPossible3wa(“not a 3wa”) returns False
isPossible3wa(“not.3wa address”) returns False
Metode ini mengambil string sebagai parameter dan mencari string untuk setiap contoh yang mungkin dari 3WA - misalnya "Tinggalkan di teras saya di Word.word.word." Kemungkinan menjadi metode utama yang dipanggil pada catatan pengiriman. Mengembalikan berbagai item yang cocok. Mengembalikan array kosong jika tidak ada kecocokan yang ditemukan. Catatan: Tidak memeriksa apakah itu 3WA yang ada.
findPossible3wa(“Please leave by my porch at filled.count.soap”) will return [‘filled.count.soap’]
findPossible3wa(“Please leave by my porch at filled.count.soap or deed.tulip.judge”) will return [‘filled.count.soap’, ‘deed.tulip.judge’]
findPossible3wa(“Please leave by my porch at”) will return []
Metode ini mengambil string sebagai parameter dan pertama kali melewatinya melalui filter Regex W3W (mirip dengan memanggil isPossible3WA () pada string) dan kemudian memanggil W3W API untuk memverifikasi itu adalah 3WA nyata.
isValid3wa(“filled.count.soap”) returns True
isValid3wa(“filled.count.”) returns False
isValid3wa(“python.is.cool”) returns False
Untuk penyimpanan yang aman dari kunci API Anda di komputer Anda, Anda dapat menentukan tombol API itu menggunakan variabel lingkungan sistem Anda.
$ export W3W_API_KEY= < Secret API Key > import what3words
from os import environ
api_key = environ [ 'W3W_API_KEY' ]
w3w = what3words . Geocoder ( api_key )
res = w3w . convert_to_coordinates ( 'prom.cape.pump' )
print ( res ) import what3words
from os import environ
api_key = environ [ 'W3W_API_KEY' ]
w3w = what3words . Geocoder ( api_key )
res = w3w . convert_to_3wa ( what3words . Coordinates ( 51.484463 , - 0.195405 ))
print ( res )Temukan bug atau ingin meminta fitur baru? Beri tahu kami dengan mengirimkan masalah.
Siapa pun dan semua orang dipersilakan untuk berkontribusi.
git checkout -b my-new-feature )git commit -am 'Add some feature' )git push origin my-new-feature )v3.3.0 30/09/24 - Dukungan lokal, perbarui regex, format dan tesv3.2.0 08/03/22 - Menambahkan Fungsi Regexv3.1.1 04/10/19 - Perbaiki bug yang terkait dengan pengaturan nilai bahasa default, dan tipe input terbesar secara otomatisv3.1.0 29/08/19 - Dukungan parameter 'preferensi -lahan' untuk panggilan otomatisv3.0.2 16/07/19 - Sertakan agen pengguna dalam permintaan APIv3.0.0 04/02/19 - Pembungkus yang diperbarui untuk menggunakan What3Words API V3v2.2.1 08/09/17 - Python 3 Setup Instal Terbaik Berkat @joedborgv2.2.0 07/09/17 - Dukungan Python 3, terima kasih kepada @Joedborgv2.1.1 07/09/17 - Perbarui ReadMe: Perpustakaan ini kompatibel dengan Python 2v2.1.0 28/03/17 - Menambahkan versi multibahasa autosuggest dan standardblendv2.0.2 27/10/16 - Diterbitkan di PYPIv2.0.0 10/06/16 - Pembungkus yang diperbarui untuk menggunakan What3Words API V2 Lisensi MIT (MIT)
Salinan lisensi tersedia di file lisensi repositori.
