إنّ عميل 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
بالإضافة إلى الوظائف التي توفّرها واجهات برمجة التطبيقات هذه، تسهّل مكتبات العملاء بعض المهام الشائعة.
- الحدّ التلقائي من معدّل الطلبات: يتم إرسال الطلبات تلقائيًا وفقًا للحدّ المتوقّع لمعدّل الطلبات لكل خدمة ويب. يمكنك تقديم حدود مخصّصة لعدد الطلبات في الدقيقة باستخدام
new GeoApiContext().setQueryRateLimit(qpm). - إعادة المحاولة عند تعذُّر الإرسال: ستعيد مكتبات العملاء تلقائيًا محاولة إرسال أي طلب إذا أرسلت واجهة برمجة التطبيقات الخطأ
5xx. تستخدم عمليات إعادة المحاولة خوارزمية الرقود الأسي الثنائي، ما يساعد في حالات الأعطال المتقطّعة. - المصادقة السهلة: تسهّل مكتبات العملاء المصادقة باستخدام مفتاح واجهة برمجة التطبيقات المتاح مجانًا. يمكن لعملاء الخطة المدفوعة من "منصة خرائط Google" استخدام معرّف العميل والرمز السري.
- POJO: تعرض مكتبات Java عناصر أصلية لكل ردّ من واجهة برمجة التطبيقات. تعرض مكتبات Python البنية كما يتم تلقّيها من واجهة برمجة التطبيقات.
- غير متزامن أو متزامن: تتيح جميع الطلبات أسلوب الاتصال المتزامن أو غير المتزامن.
الأحكام والشروط
تخضع مكتبات البرامج لخدمات الويب في "خرائط Google" لترخيص بموجب ترخيص Apache 2.0.
مكتبات العملاء هي برامج تضمين لخدمات الويب في "خرائط Google". تخضع خدمات الويب في "خرائط Google" لبنود خدمة "منصة خرائط Google".
ملاحظة مهمة: لا تشمل سياسة الإيقاف النهائي أو اتفاقية الدعم العادية من Google هذه المكتبات.
مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء
تتطلّب كل خدمة ويب في "خرائط Google" مفتاح واجهة برمجة تطبيقات أو معرّف عميل. للحصول على دليل حول الحالات التي يجب فيها استخدام مفتاح واجهة برمجة التطبيقات، والحالات التي يجب فيها استخدام معرّف العميل، وكيفية الحصول على مفتاح واجهة برمجة التطبيقات أو معرّف العميل، يُرجى الاطّلاع على دليل المصادقة لواجهة برمجة التطبيقات التي تستخدمها:
- Address Validation API
- Directions API (الإصدار القديم)
- Distance Matrix API (الإصدار القديم)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API