مكتبة Java Client وPython Client وGo Client و مكتبة Node.js Client لخدمات "خرائط Google" هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية، وهي مرخّصة بموجب Apache 2.0 License. وهي متوفرة للتنزيل والمساهمة في GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ورمز برمجي نموذجي:
- Java Client لخدمات "خرائط Google"
- برنامج Python Client لخدمة "خرائط Google"
- Go Client لخدمات "خرائط Google"
- عميل Node.js لخدمات "خرائط Google"
ما هي فائدة استخدام مكتبات العملاء؟
يتيح لك Java Client وPython Client وGo Client وNode.js Client لخدمات "خرائط 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" المميّزة استخدام معرّف العميل وسرّه.
- POJOs: تعرض مكتبات Java عناصر أصلية لكلّ من ردود واجهة برمجة التطبيقات تعرض مكتبات Python البنية كما يتم استلامها من واجهة برمجة التطبيقات.
- غير متزامن أو متزامن تتيح جميع الطلبات أسلوب الاتصال المتزامن أو غير المتزامن.
الأحكام والشروط
تم ترخيص مكتبات برامج عملاء خدمات ويب "خرائط Google" بموجب ترخيص Apache 2.0.
مكتبات العملاء هي أدوات تغليف لخدمات الويب في "خرائط Google". تخضع خدمات الويب في "خرائط Google" لبنود خدمة منصة "خرائط Google".
ملاحظة مهمة: لا تنطبق اتفاقية الدعم أو سياسة الإيقاف النهائي العادية من Google على هذه المكتبات.
مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء
تتطلّب كل خدمة ويب من "خرائط Google" مفتاح واجهة برمجة التطبيقات أو معرّف العميل. للحصول على دليل حول حالات استخدام مفتاح واجهة برمجة التطبيقات وحالات استخدام معرّف العميل وكيفية الحصول على مفتاح واجهة برمجة التطبيقات أو معرّف العميل، يمكنك الاطّلاع على دليل المصادقة لواجهة برمجة التطبيقات التي تستخدمها: