يمكنك تجربة الجيل التالي من ميزات مصفوفة المسافة مع Routes API التي تتوفّر الآن في المعاينة.

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

ما هي مزايا استخدام مكتبات العملاء؟

تمكّنك برامج Java وPython وGo Go وNode.js Client لخدمات "خرائط Google" من العمل مع خدمات الويب في "خرائط Google" على خادمك. وتغطي هذه الواجهة وظائف واجهات برمجة التطبيقات التالية:

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

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

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

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

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

ملاحظة مُهمّة: لا تغطي هذه المكتبات بموجب سياسة إيقاف Google العادية أو اتفاقية الدعم.

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

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