خدمات خرائط جوجل بيثون
v4.10.0
استخدام بايثون؟ هل تريد ترميز شيء ما جغرافيًا؟ تبحث عن الاتجاهات؟ ربما مصفوفات الاتجاهات؟ تعمل هذه المكتبة على جلب خدمات الويب الخاصة بمنصة Google Maps إلى تطبيق Python الخاص بك.
عميل Python لخدمات خرائط Google عبارة عن مكتبة عميل Python لواجهات برمجة تطبيقات خرائط Google التالية:
ضع في اعتبارك أن نفس الشروط والأحكام تنطبق على استخدام واجهات برمجة التطبيقات عند الوصول إليها من خلال هذه المكتبة.
هذه المكتبة مدعومة من المجتمع. نحن مرتاحون بما فيه الكفاية لاستقرار المكتبة وميزاتها ونريد منك إنشاء تطبيقات إنتاج حقيقية عليها. سنحاول، من خلال Stack Overflow، دعم السطح العام والمحمي للمكتبة والحفاظ على التوافق مع الإصدارات السابقة في المستقبل؛ ومع ذلك، أثناء وجود المكتبة في الإصدار 0.x، فإننا نحتفظ بالحق في إجراء تغييرات غير متوافقة مع الإصدارات السابقة. إذا قمنا بإزالة بعض الوظائف (عادةً بسبب وجود وظائف أفضل أو إذا ثبت أن الميزة غير مجدية)، فهدفنا هو إيقاف العمل ومنح المطورين عامًا لتحديث التعليمات البرمجية الخاصة بهم.
إذا وجدت خطأ، أو كان لديك اقتراح ميزة، يرجى تسجيل مشكلة. إذا كنت ترغب في المساهمة، يرجى قراءة المساهمة.
يتطلب كل طلب لخدمة الويب لخرائط Google مفتاح API أو معرف العميل. يتم إنشاء مفاتيح واجهة برمجة التطبيقات في صفحة "بيانات الاعتماد" ضمن علامة التبويب "واجهات برمجة التطبيقات والخدمات" في Google Cloud Console.
لمزيد من المعلومات حول بدء استخدام Google Maps Platform وإنشاء/تقييد مفتاح واجهة برمجة التطبيقات، راجع بدء استخدام Google Maps Platform في مستنداتنا.
هام: يجب أن يظل هذا المفتاح سريًا على الخادم الخاص بك.
$ pip install -U googlemaps
لاحظ أنك ستحتاج إلى طلبات 2.4.0 أو أعلى إذا كنت تريد تحديد مهلة الاتصال/القراءة.
يستخدم هذا المثال واجهة برمجة تطبيقات الترميز الجغرافي وواجهة برمجة تطبيقات الاتجاهات مع مفتاح واجهة برمجة التطبيقات:
import googlemaps
from datetime import datetime
gmaps = googlemaps . Client ( key = 'Add Your Key here' )
# Geocoding an address
geocode_result = gmaps . geocode ( '1600 Amphitheatre Parkway, Mountain View, CA' )
# Look up an address with reverse geocoding
reverse_geocode_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ))
# Request directions via public transit
now = datetime . now ()
directions_result = gmaps . directions ( "Sydney Town Hall" ,
"Parramatta, NSW" ,
mode = "transit" ,
departure_time = now )
# Validate an address with address validation
addressvalidation_result = gmaps . addressvalidation ([ '1600 Amphitheatre Pk' ],
regionCode = 'US' ,
locality = 'Mountain View' ,
enableUspsCass = True )
# Get an Address Descriptor of a location in the reverse geocoding response
address_descriptor_result = gmaps . reverse_geocode (( 40.714224 , - 73.961452 ), enable_address_descriptor = True )لمزيد من أمثلة الاستخدام، راجع الاختبارات.
إعادة المحاولة تلقائيًا عند حدوث حالات فشل متقطعة. وهذا يعني أنه عند إرجاع أي من أخطاء 5xx القابلة لإعادة المحاولة من واجهة برمجة التطبيقات (API).
# Installing nox
$ pip install nox
# Running tests
$ nox
# Generating documentation
$ nox -e docs
# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages
توثيق مكتبة google-maps-services-python
