w3w python wrapper
v3.3.0
Una biblioteca de Python para usar la API REST What3words.
Probado con Python 2.7, 3.4, 3.5, 3.6 (verifique Travis-Ci.org Build)
La biblioteca What3words Python le brinda acceso programático a
Para usar esta biblioteca necesitará una clave API, visite https://what3words.com/select-plan y regístrese para obtener una cuenta.
Para instalar What3Words, simplemente:
$ pip install what3wordsInstalación de la última versión de GitHub:
$ git clone https://github.com/what3words/w3w-python-wrapper.git
$ cd w3w-python-wrapper
$ python setup.py install Esta función toma el parámetro de palabras como una cadena de 3 palabras 'table.book.chair'
La carga útil devuelta del método convert-to-coordinates se describe en la documentación de la API REST WHILE3WORDS.
Esta función toma la latitud y la longitud:
lat=0.1234 , lng=1.5678 La carga útil devuelta del método convert-to-3wa se describe en la documentación de la API REST What3words.
Devuelve una lista de direcciones de 3 palabras basadas en la entrada del usuario y otros parámetros.
Este método proporciona correcciones para los siguientes tipos de error de entrada:
El método autosuggest determina posibles correcciones a la cadena de dirección de 3 palabras suministrada en función de la probabilidad de los errores de entrada enumerados anteriormente y devuelve una lista clasificada de sugerencias. Este método también puede tener en cuenta la proximidad geográfica de posibles correcciones a una ubicación determinada para mejorar aún más las sugerencias devueltas.
Solo recibirá los resultados si la cadena de dirección parcial de 3 palabras que envía contiene las dos primeras palabras y al menos el primer carácter de la tercera palabra; de lo contrario, se devolverá un mensaje de error.
Proporcionamos varias políticas clip para permitirle especificar un área geográfica que se utiliza para excluir los resultados que probablemente no sean relevantes para sus usuarios. Le recomendamos que use el parámetro clip para dar un conjunto de resultados más dirigido y más corto a su usuario. Si conoce la ubicación actual de su usuario, también recomendamos encarecidamente que use el focus para devolver los resultados que probablemente sean más relevantes.
En resumen, la política clip se utiliza para restringir opcionalmente la lista de resultados de autogestiones candidatos, después de lo cual, si se ha suministrado el enfoque, esto se utilizará para clasificar los resultados en orden de relevancia para el enfoque.
https://docs.what3words.com/api/v3/#autosuggest
La carga útil devuelta del método autosuggest se describe en la documentación de la API REST What3words.
Devuelve una sección de la cuadrícula 3M x 3M What3words para un cuadro delimitador.
Recupera una lista de los idiomas de dirección de 3 palabras cargados y disponibles actualmente.
La carga útil devuelta del método available-languages se describe en la documentación de la API REST What3words.
Este método toma una cadena como parámetro y devuelve si la cadena está en el formato de un 3WA (por ejemplo, "Llenado.count.soap"). El tipo de retorno es booleano. Nota: No verifica si es un 3WA existente real.
isPossible3wa(“filled.count.soap”) returns True
isPossible3wa(“not a 3wa”) returns False
isPossible3wa(“not.3wa address”) returns False
Este método toma una cadena como parámetro y busca la cadena para cualquier posible instancia de un 3WA, por ejemplo, "Deja en mi porche en Word.word.word". Es probable que sea el método principal que se solicite en las notas de entrega. Devuelve una matriz de elementos coincidentes. Devuelve una matriz vacía si no se encuentran coincidencias. Nota: No verifica si es un 3WA existente real.
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 []
Este método toma una cadena como parámetro y primero la pasa a través del filtro Regex W3W (similar a llamar a ISPossible3wa () en la cadena) y luego llama a la API W3W para verificar que es un 3WA real.
isValid3wa(“filled.count.soap”) returns True
isValid3wa(“filled.count.”) returns False
isValid3wa(“python.is.cool”) returns False
Para el almacenamiento seguro de su tecla API en su computadora, puede definir esa tecla API utilizando las variables de entorno de su sistema.
$ 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 )¿Encuentra un error o quieres solicitar una nueva función? Háganos saber enviando un problema.
Cualquiera y todos pueden contribuir.
git checkout -b my-new-feature )git commit -am 'Add some feature' )git push origin my-new-feature )v3.3.0 30/09/24 - Soporte de ubicación, actualización regex, formato y pruebasv3.2.0 03/03/22 - Funciones reglas agregadasv3.1.1 04/10/19 - Se corrigió errores relacionados con la configuración del valor de idioma predeterminado y el tipo de entrada de AutoSuggestv3.1.0 29/08/19 - Soporte de parámetro 'prefer -tierna' para llamadas de autosuggestv3.0.2 16/07/19 - Incluya el agente de usuario en las solicitudes de APIv3.0.0 02/02/19 - Envoltura actualizada para usar What3words API V3v2.2.1 09/08/17 - Instalación de configuración de Python 3 solucionada gracias a @joedborgv2.2.0 07/07/17 - Soporte de Python 3, gracias a @joedborgv2.1.1 07/07/17 - Actualización de lectura: esta biblioteca es compatible con Python 2v2.1.0 28/03/17 - Versión multilingüe agregada de autosuggest y standardblendv2.0.2 27/10/16 - Publicado en Pypiv2.0.0 10/06/16 - Envoltura actualizada para usar What3words API V2 La licencia del MIT (MIT)
Una copia de la licencia está disponible en el archivo de licencia del repositorio.
