إنّ عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google" هي مكتبات عملاء يدعمها المنتدى، ويتم إصدارها كبرنامج مفتوح المصدر بموجب ترخيص Apache 2.0. وهي متاحة للتنزيل والمساهمة على GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت والرمز النموذجي:
- برنامج Java لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- عميل Go لخدمات "خرائط Google"
- عميل Node.js لخدمات "خرائط Google"
ما هي مزايا استخدام مكتبات العملاء؟
يتيح لك عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google" العمل مع خدمات الويب في "خرائط Google" على خادمك. وهي تغلّف وظائف واجهات برمجة التطبيقات التالية:
- Address Validation API
- Directions API (الإصدار القديم)
- Distance Matrix API (الإصدار القديم)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API
بالإضافة إلى الوظائف التي توفّرها واجهات برمجة التطبيقات هذه، تعمل مكتبات العملاء على تبسيط المهام الشائعة:
- الحدّ التلقائي من معدّل الزيارات: يرسل الطلبات بالمعدّل المتوقّع لكل خدمة ويب تلقائيًا. يمكنك تقديم حدود مخصّصة لعدد الطلبات في الدقيقة (QPM) باستخدام
new GeoApiContext().setQueryRateLimit(qpm). - إعادة المحاولة عند تعذُّر الإرسال: تتم إعادة محاولة إرسال أي طلب تلقائيًا عندما ترسل واجهة برمجة التطبيقات خطأ من المستوى 500، وذلك باستخدام خوارزمية الرقود الأسي الثنائي للمساعدة في معالجة حالات تعذُّر الإرسال المتقطعة.
- المصادقة المباشرة: تتيح لك المصادقة باستخدام مفتاح واجهة برمجة التطبيقات أو باستخدام معرّف العميل والسر لعملاء الخطة المدفوعة من "منصة خرائط Google".
- كائنات Java القديمة العادية (POJO): تعرض كائنات Java المكتوبة لكل ردّ من واجهة برمجة التطبيقات في مكتبة Java، بينما تعرض مكتبة Python بنية الردّ مباشرةً من واجهة برمجة التطبيقات.
- المكالمات المتزامنة أو غير المتزامنة: تتيح استخدام أسلوبَي المكالمات المتزامنة وغير المتزامنة لجميع الطلبات.
الأحكام والشروط
يتم ترخيص مكتبات البرامج لخدمات الويب في "خرائط Google" بموجب ترخيص Apache 2.0.
مكتبات العملاء هي برامج تضمين لخدمات الويب في "خرائط Google"، والتي تخضع لبنود خدمة "منصة خرائط Google".
مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء
تتطلّب كل خدمة ويب في "خرائط Google" مفتاح واجهة برمجة تطبيقات أو معرّف عميل. لمزيد من المعلومات حول الحالات التي يجب فيها استخدام مفتاح واجهة برمجة التطبيقات أو معرّف العميل، وكيفية الحصول على مفتاح واجهة برمجة التطبيقات أو معرّف العميل، يُرجى الاطّلاع على دليل المصادقة لواجهة برمجة التطبيقات التي تستخدمها:
- Address Validation API
- Directions API (الإصدار القديم)
- Distance Matrix API (الإصدار القديم)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API