تكوين وكيل لعميل Google Maps بلغة Python

يرسل عميل googlemaps لبايثون طلبات خدمة الويب الخاصة به عبر Requests. مرّر خيارات Requests عبر قاموس requests_kwargs الخاص بالعميل:

import googlemaps

gmaps = googlemaps.Client(
    key=maps_api_key,
    connect_timeout=5,
    read_timeout=30,
    requests_kwargs={
        'proxies': {
            'http': 'http://proxy.example:8080',
            'https': 'http://proxy.example:8080',
        },
    },
)

maps_api_key هو مفتاح API الحالي للتطبيق. استخدم نسخة gmaps هذه للطلبات المقصودة. يمكن لمرشح HTTP من قائمة وكلاء HTTP أن يوفر المسار لطلب Maps API عام مسموح به عندما لا تكون للجلسة المختارة بيانات اعتماد وكيل.

قيمة proxies هي خريطة من مخطط الوجهة إلى عنوان URL للوكيل. وهي ليست زوج host/port ولا سلسلة وكيل واحدة غير منظمة. يمكن لوجهة HTTPS استخدام نقطة نهاية وكيل HTTP الموضحة هنا.

يدمج العميل هذه الخيارات في استدعاء Requests الذي يجريه. لا يضبط requests.get المستقل في مكان آخر من التطبيق هذا العميل، ولعميل googlemaps.Client آخر أُنشئ دون هذه الخيارات إعداده الخاص.

للتكامل الأطول عمراً الذي يملك بالفعل جلسة Requests، تقبل المكتبة أيضاً requests_session. حافظ على سياسة الجلسة وملكيتها بشكل مدروس عند مشاركتها. لا يزال مفتاح API يصادق على طلب Maps؛ وبيانات اعتماد الوكيل، إن لزمت، تنتمي إلى ترتيب المصادقة الذي يدعمه الوسيط.