w3w python wrapper下載w3w python wrapper源代碼下載

w3w python wrapper

其他源碼

v3.3.0

下載

W3W-PYTHON-WRAPPER

Python庫使用What3Words REST API。

用Python 2.7、3.4、3.5、3.6測試（檢查Travis-ci.org構建）

概述

what3words python庫為您提供了程序化訪問

將3個單詞地址轉換為坐標
將坐標轉換為3個單詞地址
AutoSuggest功能，該功能略有不正確的3個單詞地址，並建議有效的3個單詞地址列表
獲取一個邊界框的3M x 3M What3words網格的部分。
確定當前支持3個單詞地址語言。

驗證

要使用此庫，您需要一個API密鑰，請訪問https://what3words.com/select-plan並註冊一個帳戶。

安裝

PYPI安裝

要安裝What What 3words，簡單地：

$ pip install what3words

github安裝

從GitHub安裝最新版本：

$ git clone https://github.com/what3words/w3w-python-wrapper.git
$ cd w3w-python-wrapper
$ python setup.py install

轉換為坐標

此函數將單詞參數作為3個單詞的字符串'table.book.chair'

What3Words REST API文檔中描述了從convert-to-coordinates方法返回的有效載荷。

轉換為3個單詞地址

此功能採用緯度和經度：

2個參數： lat=0.1234 ， lng=1.5678

What3Words REST API文檔中描述了從convert-to-3wa方法返回的有效載荷。

Autosuggest

根據用戶輸入和其他參數返回3個單詞地址的列表。

此方法為以下類型的輸入錯誤提供更正：

輸入錯誤
拼寫錯誤
誤會單詞（例如，單數與復數）
單詞錯誤的順序

autosuggest方法根據上述輸入錯誤的概率確定了對所提供的3個單詞地址字符串的可能更正，並返回了排名的建議列表。該方法還可以考慮到可能的校正與給定位置的地理距離，以進一步改善返回的建議。

輸入3個單詞地址

只有當您提交的部分3個單詞字符串包含前兩個單詞和至少第三個單詞的第一個字符時，您才會收到結果；否則，將返回錯誤消息。

剪裁和聚焦

我們提供各種clip策略，允許您指定用於排除不太可能與用戶相關的結果的地理區域。我們建議您使用clip參數為您的用戶提供更具針對性的更短的結果集。如果您知道用戶當前的位置，我們還強烈建議您使用focus返回可能更相關的結果。

總而言之， clip策略用於選擇限制候選Autosuggest結果列表，然後如果提供了焦點，則將使用該結果來對結果進行排名，以與重點相關。

https://docs.what3words.com/api/v3/#autosuggest

What3Words REST API文檔中描述了從autosuggest方法返回的有效載荷。

網格部分

返回一個邊界框的3M x 3M What 3words網格的一部分。

可用語言

檢索當前加載和可用的3個單詞地址語言的列表。

What3words REST API文檔中描述了從available-languages方法中返回的有效載荷。

Ispossible3wa

此方法將字符串作為參數，並返回字符串是否為3WA格式（例如“ fill.count.soap”）。返回類型是布爾值。注意：不要檢查它是否是現有的現有3WA。

 isPossible3wa(“filled.count.soap”) returns True
isPossible3wa(“not a 3wa”) returns False
isPossible3wa(“not.3wa address”) returns False

findpossible3wa

此方法將字符串作為參數，並蒐索字符串以獲取3WA的任何可能實例 - 可能是交貨說明中稱為的主要方法。返回一系列匹配的項目。如果找不到匹配，則返回一個空數組。注意：不要檢查它是否是現有的現有3WA。

 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 []

ISVALID3WA

該方法將字符串作為參數採用，然後首先將其通過W3W Regex過濾器（類似於字符串上的iSpossible3wa（）），然後調用W3W API以驗證它是真實的3WA。

 isValid3wa(“filled.count.soap”) returns True
isValid3wa(“filled.count.”) returns False
isValid3wa(“python.is.cool”) returns False

代碼示例

W3W-API-KEY

為了在計算機上安全存儲API鍵，可以使用系統的環境變量來定義該API鍵。

$ 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 )

轉換為3個單詞地址

 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 )