w3w python wrapper
v3.3.0
What3words Rest API를 사용하는 파이썬 라이브러리.
Python 2.7, 3.4, 3.5, 3.6으로 테스트 (travis-ci.org 빌드 확인)
What3words Python Library는 프로그래밍 방식으로 액세스 할 수 있습니다
이 라이브러리를 사용하려면 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 메소드의 반환 된 페이로드는 What3words rest API 문서에 설명되어 있습니다.
이 기능은 위도와 경도를 취합니다.
lat=0.1234 , lng=1.5678 convert-to-3wa 메소드의 반환 된 페이로드는 What3words rest API 문서에 설명되어 있습니다.
사용자 입력 및 기타 매개 변수를 기반으로 3 개의 단어 주소 목록을 반환합니다.
이 방법은 다음 유형의 입력 오류에 대한 수정 사항을 제공합니다.
autosuggest 방법은 위에 나열된 입력 오류의 확률에 따라 제공된 3 단어 주소 문자열에 대한 가능한 수정을 결정하고 순위가 매겨진 제안 목록을 반환합니다. 이 방법은 또한 주어진 위치에 대한 가능한 수정의 지리적 근접성을 고려하여 반환 된 제안을 더욱 향상시킬 수 있습니다.
제출 한 부분 3 단어 주소 문자열에 첫 두 단어와 세 번째 단어의 첫 번째 문자가 포함 된 경우에만 결과를 받게됩니다. 그렇지 않으면 오류 메시지가 반환됩니다.
우리는 사용자와 관련이없는 결과를 배제하는 데 사용되는 지리적 영역을 지정할 수있는 다양한 clip 정책을 제공합니다. clip 매개 변수를 사용하여 사용자에게보다 타겟팅 된 짧은 결과 세트를 제공하는 것이 좋습니다. 사용자의 현재 위치를 알고 있다면 focus 사용하여 더 관련성이 높은 결과를 반환하는 것이 좋습니다.
요약하면, clip 정책은 후보자 자동 공급 결과 목록을 선택적으로 제한하는 데 사용되며, 그 후 초점이 공급 된 경우 초점과 관련된 결과를 순서대로 순위로 순위를 매기는 데 사용됩니다.
https://docs.what3words.com/api/v3/#autosuggest
autosuggest 방법의 반환 된 페이로드는 What3words Rest API 문서에 설명되어 있습니다.
경계 상자의 3m x 3m what3words 그리드 섹션을 반환합니다.
현재로드되고 사용 가능한 3 개의 단어 주소 언어 목록을 검색합니다.
available-languages 방법에서 반환 된 페이로드는 What3words Rest API 문서에 설명되어 있습니다.
이 메소드는 문자열을 매개 변수로 사용하고 문자열이 3WA 형식인지 여부를 반환합니다 (예 : "closed.count.soap"). 반환 유형은 부울입니다. 참고 : 실제 기존 3WA인지 확인하지 않습니다.
isPossible3wa(“filled.count.soap”) returns True
isPossible3wa(“not a 3wa”) returns False
isPossible3wa(“not.3wa address”) returns False
이 메소드는 매개 변수로 문자열을 취하고 3WA - "Word.word.word에서 현관에 남겨 두는 경우"의 가능한 인스턴스에 대해 문자열을 검색합니다. 배달 노트에서 호출되는 주요 방법 일 것입니다. 일치하는 항목 배열을 반환합니다. 일치가없는 경우 빈 배열을 반환합니다. 참고 : 실제 기존 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- 기본 언어 값 설정과 관련된 버그 수정 및 자동 제공 입력 유형v3.1.0 29/08/19- AutoSuggest 통화를위한 'Prefer -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)
라이센스 사본은 저장소의 라이센스 파일에서 제공됩니다.
