مكتبات العملاء لخدمات الويب في خرائط Google
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مكتبة Java Client وPython Client وGo Client و
مكتبة Node.js Client لخدمات "خرائط Google" هي مكتبات عملاء مفتوحة المصدر تدعمها جهات خارجية، وهي مرخّصة بموجب
Apache 2.0 License. وهي متوفرة للتنزيل والمساهمة في GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ورمز برمجي نموذجي:
ما هي فائدة استخدام مكتبات العملاء؟
يتيح لك Java Client وPython Client وGo Client
وNode.js Client لخدمات "خرائط Google" العمل مع خدمات الويب في "خرائط Google" على خادمك.
وهي توفّر وظائف واجهات برمجة التطبيقات التالية:
بالإضافة إلى الوظائف التي تقدّمها واجهات برمجة التطبيقات هذه، تسهّل مكتبات العملاء
بعض المهام الشائعة.
- وضع "تقييد معدّل الإرسال" التلقائي: يتم إرسال الطلبات تلقائيًا بمعدّل الإرسال المتوقع
لكل خدمة ويب. يمكنك تقديم حدود مخصّصة للطلبات في الدقيقة باستخدام
new GeoApiContext().setQueryRateLimit(qpm).
- إعادة المحاولة عند حدوث خطأ ستعيد مكتبات العملاء تلقائيًا محاولة إرسال أي
طلب إذا أرسلت واجهة برمجة التطبيقات خطأ
5xx. تستخدِم عمليات إعادة المحاولة أسلوب "التراجع الدليلي"،
ما يساعد في حال حدوث أعطال متقطّعة.
- المصادقة السهلة: تسهِّل مكتبات العملاء عملية المصادقة
باستخدام مفتاح واجهة برمجة التطبيقات المتاح مجانًا. يمكن لعملاء خطة "منصة خرائط Google" المميّزة
استخدام معرّف العميل وسرّه.
- POJOs: تعرض مكتبات Java عناصر أصلية لكلّ من ردود واجهة برمجة التطبيقات
تعرض مكتبات Python البنية كما يتم استلامها من واجهة برمجة التطبيقات.
- غير متزامن أو متزامن تتيح جميع الطلبات أسلوب الاتصال المتزامن أو
غير المتزامن.
الأحكام والشروط
تم ترخيص مكتبات برامج عملاء خدمات ويب "خرائط Google" بموجب
ترخيص Apache 2.0.
مكتبات العملاء هي أدوات تغليف لخدمات الويب في "خرائط Google". تخضع خدمات الويب في "خرائط Google"
لبنود خدمة منصة "خرائط Google".
ملاحظة مهمة: لا تنطبق
اتفاقية الدعم أو سياسة الإيقاف النهائي العادية من Google على هذه المكتبات.
مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء
تتطلّب كل خدمة ويب من "خرائط Google" مفتاح واجهة برمجة التطبيقات أو معرّف العميل. للحصول على دليل حول
حالات استخدام مفتاح واجهة برمجة التطبيقات وحالات استخدام معرّف العميل وكيفية الحصول على
مفتاح واجهة برمجة التطبيقات أو معرّف العميل، يمكنك الاطّلاع على دليل المصادقة لواجهة برمجة التطبيقات التي تستخدمها:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCommunity-supported client libraries for Google Maps Services are available in Java, Python, Go, and Node.js, offering convenient access to various Google Maps APIs like Directions, Geocoding, and Places.\u003c/p\u003e\n"],["\u003cp\u003eThese open-source libraries, under the Apache 2.0 License, provide features such as automatic rate limiting, retry on failure, easy authentication, and support for both synchronous and asynchronous calls.\u003c/p\u003e\n"],["\u003cp\u003eThey are governed by the Google Maps Platform Terms of Service and are not covered by the standard Google deprecation policy or support agreement.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Maps web service requires an API key or client ID for authentication, with specific guides available for each API.\u003c/p\u003e\n"]]],[],null,["# Client Libraries for Google Maps Web Services\n\nThe Java Client, Python Client, Go Client and\nNode.js Client for Google Maps Services are community supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0). They are\navailable for download and contributions on GitHub, where you will also find installation\ninstructions and sample code: \n\n- [Java Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nWhy use the client libraries?\n-----------------------------\n\nThe Java Client, Python Client, Go Client\nand Node.js Client for Google Maps Services enable you to work with Google Maps web services on your server.\nThey wrap the functionality of the following APIs:\n\n- [Address Validation API](/maps/documentation/address-validation/overview)\n- [Directions API (Legacy)](/maps/documentation/directions/start)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/start)\n- [Elevation API](/maps/documentation/elevation/start)\n- [Geocoding API](/maps/documentation/geocoding/start)\n- [Places API](/maps/documentation/places/web-service/overview)\n- [Roads API](/maps/documentation/roads/overview)\n- [Time Zone API](/maps/documentation/timezone/start)\n\nIn addition to the functionality provided by these APIs, the client libraries\nmake some common tasks a little easier.\n\n- **Automatic Rate Limiting** By default, requests are sent at the expected rate limit for each web service. You can provide custom QPM limits with `new GeoApiContext().setQueryRateLimit(qpm)`.\n- **Retry on Failure** The client libraries will automatically retry any request if the API sends a `5xx` error. Retries use exponential back-off, which helps in the event of intermittent failures.\n- **Easy Authentication** The client libraries make it easy to authenticate with your freely available API Key. [Google Maps Platform Premium Plan](/maps/premium) customers can use their [client ID and secret](/maps/premium/overview#client-id).\n- **POJOs** The Java libraries return native objects for each of the API responses. The Python libraries return the structure as it is received from the API.\n- **Asynchronous or synchronous** All requests support synchronous or asynchronous calling style.\n\nTerms and conditions\n--------------------\n\nThe client libraries for the Google Maps web services are licensed under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\n\nThe client libraries are wrappers for the Google Maps web services. The Google Maps\nweb services are governed by the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).\n\n**Important** : These libraries are **not covered**\nby the standard Google deprecation policy or support agreement.\n\nAPI keys and client IDs\n-----------------------\n\nEach Google Maps web service requires an API key or client ID. For a guide on\nwhen to use an API key, when to use a client ID, and how to get hold of your\nAPI key or client ID, see the authentication guide for the API you're using:\n\n- [Address Validation API](/maps/documentation/address-validation/get-api-key)\n- [Directions API (Legacy)](/maps/documentation/directions/get-api-key)\n- [Distance Matrix API (Legacy)](/maps/documentation/distancematrix/get-api-key)\n- [Elevation API](/maps/documentation/elevation/get-api-key)\n- [Geocoding API](/maps/documentation/geocoding/get-api-key)\n- [Places API](/maps/documentation/places/web-service/get-api-key)\n- [Roads API](/maps/documentation/roads/get-api-key)\n- [Time Zone API](/maps/documentation/timezone/get-api-key)"]]
