w3w python wrapper
v3.3.0
What3Words REST APIを使用するPythonライブラリ。
python 2.7、3.4、3.5、3.6でテスト
What3Words Pythonライブラリは、プログラム的なアクセスを提供します
このライブラリを使用するには、APIキーが必要です。https：//what3words.com/select-planにアクセスして、アカウントにサインアップしてください。
what3wordsをインストールするには、単純に：
$ pip install what3wordsGitHubから最新バージョンをインストールする：
$ git clone https://github.com/what3words/w3w-python-wrapper.git
$ cd w3w-python-wrapper
$ python setup.py installこの関数は、単語パラメーターを3つの単語'table.book.chair'の文字列として取得します
convert-to-coordinatesメソッドからの返されたペイロードは、Whow3Words REST APIドキュメントで説明されています。
この関数は緯度と経度を取ります：
lat=0.1234 、 lng=1.5678 convert-to-3waメソッドからの返されたペイロードは、WHOW3WORDS REST APIドキュメントで説明されています。
ユーザー入力およびその他のパラメーターに基づいて、3つの単語アドレスのリストを返します。
この方法は、次の種類の入力エラーの修正を提供します。
autosuggestメソッドは、上記の入力エラーの確率に基づいて、付属の3つの単語アドレス文字列に対する可能な修正を決定し、ランク付けされた提案リストを返します。この方法は、特定の場所に可能な修正が特定の場所に近接していることを考慮すると、返された提案をさらに改善することもできます。
提出した部分的な3つの単語アドレス文字列に最初の2つの単語と少なくとも3番目の単語の最初の文字が含まれている場合にのみ、結果を受け取ります。それ以外の場合、エラーメッセージが返されます。
さまざまなclipポリシーを提供して、ユーザーに関連する可能性が低い結果を除外するために使用される地理的領域を指定できるようにします。 clipパラメーターを使用して、よりターゲットを絞った短い結果の結果をユーザーに提供することをお勧めします。ユーザーの現在の場所がわかっている場合は、より関連性が高い可能性のある結果を返すためにfocusを使用することを強くお勧めします。
要約すると、 clipポリシーを使用して、オプションで候補者の自動統治結果のリストを制限します。その後、フォーカスが提供された場合、これを使用して結果をフォーカスに関連する順にランク付けします。
https://docs.what3words.com/api/v3/#autosuggest
autosuggestメソッドからの返されたペイロードは、Whow3Words REST APIドキュメントで説明されています。
境界ボックス用の3m x 3m what3wordsグリッドのセクションを返します。
現在ロードされており、利用可能な3つのワードアドレス言語のリストを取得します。
available-languagesメソッドからの返されたペイロードは、Whow3Words REST APIドキュメントで説明されています。
このメソッドは、文字列をパラメーターとして取得し、文字列が3WAの形式であるかどうかを返します（例：「fill.count.soap」）。戻りタイプはブール奏者です。注：実際の既存の3WAであるかどうかを確認しません。
isPossible3wa(“filled.count.soap”) returns True
isPossible3wa(“not a 3wa”) returns False
isPossible3wa(“not.3wa address”) returns False
このメソッドは、文字列をパラメーターとして使用し、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 []
このメソッドは、文字列をパラメーターとして使用し、最初にW3W Regexフィルター（文字列上のiSPossible3wa（）を呼び出すのと同じように）に渡し、次にW3W APIを呼び出して実際の3WAであることを確認します。
isValid3wa(“filled.count.soap”) returns True
isValid3wa(“filled.count.”) returns False
isValid3wa(“python.is.cool”) returns False
コンピューターに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 ) 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 )バグを見つけたり、新しい機能を要求したりしたいですか？問題を提出してお知らせください。
誰でも、誰でも貢献できます。
git checkout -b my-new-feature ）git commit -am 'Add some feature' ）git push origin my-new-feature ）v3.3.0 30/09/24-サポートロケール、Regex、フォーマット、テストの更新v3.2.0 08/03/22-は、regex関数を追加しましたv3.1.1 04/10/19-デフォルトの言語値の設定に関連するバグを修正し、AutoSuggest input -typev3.1.0 29/08/19-オートスポゲストコールのサポート「fort -land」パラメーターv3.0.2 16/07/19- APIリクエストにユーザーエージェントを含めますv3.0.0 04/02/19- what3words api v3を使用するためにラッパーを更新しましたv2.2.1 08/09/17 -python 3セットアップインストール@joedborgのおかげで修正v2.2.0 07/09/17- @Joedborgのおかげで、Python 3サポートv2.1.1 07/09/17-更新readme：このライブラリはpython 2と互換性がありますv2.1.0 28/03/17- autosuggestとstandardblendの多言語バージョンを追加v2.0.2 27/10/16- Pypiで公開v2.0.0 10/06/16- what3words api v2を使用するためにラッパーを更新しましたMITライセンス（MIT）
ライセンスのコピーは、リポジトリのライセンスファイルで入手できます。
