w3w python wrapper
v3.3.0
مكتبة Python لاستخدام What3Words REST API.
تم اختباره باستخدام Python 2.7 ، 3.4 ، 3.5 ، 3.6 (تحقق من Travis-Ci.org)
تمنحك مكتبة What3Words Python الوصول البرنامجي إلى
لاستخدام هذه المكتبة ، ستحتاج إلى مفتاح API ، يرجى زيارة https://what3words.com/select-plan والتسجيل للحصول على حساب.
لتثبيت What3words ، ببساطة:
$ pip install what3wordsتثبيت أحدث إصدار من جيثب:
$ 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 Word بناءً على احتمال أخطاء الإدخال المذكورة أعلاه وإرجاع قائمة من الاقتراحات المرتبة. يمكن أن تأخذ هذه الطريقة أيضًا في الاعتبار القرب الجغرافي من التصحيحات المحتملة إلى موقع معين لزيادة تحسين الاقتراحات التي تم إرجاعها.
سوف تتلقى فقط النتائج مرة أخرى إذا كانت سلسلة عنوان Word 3 الجزئية التي ترسلها تحتوي على الكلمتين الأولين وعلى الأقل الحرف الأول للكلمة الثالثة ؛ وإلا سيتم إرجاع رسالة خطأ.
نحن نقدم سياسات clip مختلفة للسماح لك بتحديد منطقة جغرافية تستخدم لاستبعاد النتائج التي من غير المحتمل أن تكون ذات صلة بالمستخدمين. نوصيك باستخدام معلمة clip لإعطاء مجموعة أكثر استهدافًا وأقصر من النتائج للمستخدم. إذا كنت تعرف موقع المستخدم الحالي الخاص بك ، فإننا نوصي بشدة باستخدام focus لإرجاع النتائج التي من المحتمل أن تكون أكثر أهمية.
باختصار ، يتم استخدام سياسة clip لتقييد قائمة النتائج المرشحة للمرشحين ، وبعد ذلك ، إذا تم توفير التركيز ، فسيتم استخدام ذلك لتصنيف النتائج بترتيب الصلة بالتركيز.
https://docs.what3words.com/api/v3/#autosuggest
يتم وصف الحمولة النافعة التي تم إرجاعها من الطريقة autosuggest في وثائق What3Words REST API.
إرجاع قسم من شبكة 3M × 3M What3words لمربع محيط.
يسترجع قائمة لغات عنوان الكلمات المحملة حاليًا والمتاحة.
تم وصف الحمولة النافعة التي تم إرجاعها من طريقة available-languages في وثائق What3Words REST API.
تأخذ هذه الطريقة سلسلة كمعلمة وإرجاع ما إذا كانت السلسلة بتنسيق 3WA (على سبيل المثال "lower.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 للتحقق من أنه 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-featurev3.3.0 30/09/24 - لغة الدعم ، تحديث regex ، التنسيق والاختباراتv3.2.0 08/03/22 - إضافة وظائف regexv3.1.1 04/10/19 - إصلاح الأخطاء المتعلقة بإعداد قيمة اللغة الافتراضية ، و Autosuggest -type -typev3.1.0 29/08/19 - دعم المعلمة "تفضيل الأراضي" للمكالمات Autosuggestv3.0.2 16/07/19 - قم بتضمين عامل المستخدم في طلبات APIv3.0.0 04/02/19 - Wrapper تم تحديث لاستخدام What3Words API V3v2.2.1 08/09/17 - تثبيت Python 3 تثبيت ثابت بفضل @joedborgv2.2.0 07/09/17 - دعم بيثون 3 ، بفضل @joedborgv2.1.1 07/09/17 - تحديث ReadMe: هذه المكتبة متوافقة مع Python 2v2.1.0 28/03/17 - إضافة نسخة متعددة اللغات من autosuggest و standardblendv2.0.2 27/10/16 - تم نشره على PYPIv2.0.0 10/06/16 - تم تحديث التفاف لاستخدام What3Words API V2 ترخيص معهد ماساتشوستس للتكنولوجيا (MIT)
تتوفر نسخة من الترخيص في ملف ترخيص المستودع.
