مكتبات العملاء لخدمات الويب في خرائط Google

إنّ Java Client وPython Client وGo Client و Node.js Client for Google Maps Services هي مكتبات عملاء معتمدة من المنتدى، ومفتوحة المصدر بموجب ترخيص Apache 2.0. ويمكنك تنزيلها وتقديم مساهمات لها على GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرموز:

لماذا يُنصح باستخدام مكتبات العملاء؟

يتيح لك كل من Java Client وPython Client وGo Client وNode.js Client for Google Maps Services استخدام خدمات الويب في "خرائط Google" على خادمك. تتضمن وظائف واجهات برمجة التطبيقات التالية:

بالإضافة إلى الوظائف التي توفّرها واجهات برمجة التطبيقات هذه، تسهّل مكتبات العميل على بعض المهام الشائعة بعض الشيء.

  • الحدّ الأقصى لمعدّل الزحف بشكل تلقائي، يتم إرسال الطلبات تلقائيًا بحدّ المعدّل المتوقّع لكل خدمة ويب. يمكنك تقديم حدود مخصّصة لعدد الطلبات في الثانية (QPS) من خلال new GeoApiContext().setQueryRateLimit(qps).
  • إعادة المحاولة عند التعذُّر: ستعيد مكتبات البرامج محاولة إرسال أي طلب تلقائيًا إذا أرسلت واجهة برمجة التطبيقات الخطأ 5xx. تستخدم عمليات إعادة المحاولة التراجع الأُسيّ، وهو ما يساعد في حال حدوث إخفاقات متقطّعة.
  • المصادقة السهلة تسهِّل مكتبات العميل إجراء المصادقة باستخدام مفتاح واجهة برمجة التطبيقات المتاح مجانًا. يمكن لعملاء الخطة المميّزة في "منصة خرائط Google" استخدام معرّف العميل وسرّه.
  • POJOs تعرِض مكتبات Java كائنات أصلية لكل استجابات من واجهة برمجة التطبيقات. تعرِض مكتبات بايثون البنية كما يتم استلامها من واجهة برمجة التطبيقات.
  • غير متزامن أو غير متزامن تتيح جميع الطلبات استخدام أسلوب الاتصال المتزامن أو غير المتزامن.

الأحكام والشروط

يتم ترخيص مكتبات العملاء لخدمات الويب في "خرائط Google" بموجب ترخيص Apache 2.0.

مكتبات العملاء هي برامج تضمين لخدمات الويب في "خرائط Google". تخضع خدمات "خرائط Google" على الويب لبنود خدمة "منصة خرائط Google".

ملاحظة مهمة: هذه المكتبات غير مشمولة بسياسة الإيقاف النهائي العادية من Google أو اتفاقية الدعم.

مفاتيح واجهة برمجة التطبيقات ومعرِّفات العملاء

تتطلّب كل خدمة ويب في "خرائط Google" مفتاح واجهة برمجة التطبيقات أو معرِّف عميل. للاطّلاع على دليل حول الحالات التي يمكن فيها استخدام مفتاح واجهة برمجة التطبيقات والحالات التي يتم فيها استخدام معرِّف العميل وكيفية الحصول على مفتاح واجهة برمجة التطبيقات أو معرِّف العميل، يُرجى الاطّلاع على دليل المصادقة لواجهة برمجة التطبيقات التي تستخدمها: