این محصول یا ویژگی در وضعیت Legacy است. For more information about Legacy status and how to migrate from Legacy to newer services, see
Legacy products and features .
کتابخانه های مشتری برای خدمات وب Google Maps
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps، کتابخانه های سرویس گیرنده پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها برای دانلود و مشارکت در GitHub در دسترس هستند، جایی که دستورالعمل های نصب و کد نمونه را نیز خواهید یافت:
چرا از کتابخانه های مشتری استفاده کنیم؟
Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps شما را قادر می سازد با سرویس های وب Google Maps در سرور خود کار کنید. آنها عملکرد API های زیر را در بر می گیرند:
علاوه بر عملکرد ارائه شده توسط این API ها، کتابخانه های سرویس گیرنده برخی از وظایف رایج را کمی آسان تر می کند.
- محدودیت نرخ خودکار به طور پیش فرض، درخواست ها با محدودیت نرخ مورد انتظار برای هر سرویس وب ارسال می شوند. می توانید محدودیت های سفارشی QPM را با
new GeoApiContext().setQueryRateLimit(qpm) ارائه دهید. - اگر API یک خطای
5xx ارسال کند، کتابخانه های سرویس گیرنده به طور خودکار هر درخواستی را دوباره امتحان می کنند. تلاش‌های مجدد از عقب‌نشینی نمایی استفاده می‌کند، که در صورت خرابی‌های متناوب کمک می‌کند. - احراز هویت آسان کتابخانه های سرویس گیرنده احراز هویت با کلید API آزادانه شما را آسان می کنند. مشتریان طرح ممتاز پلتفرم Google Maps می توانند از شناسه مشتری و راز خود استفاده کنند.
- POJO ها کتابخانه های جاوا اشیاء بومی را برای هر یک از پاسخ های API برمی گرداند. کتابخانه های پایتون ساختار را همانطور که از API دریافت می کند برمی گرداند.
- ناهمزمان یا همزمان همه درخواست‌ها از سبک تماس همزمان یا ناهمزمان پشتیبانی می‌کنند.
شرایط و ضوابط
کتابخانه های سرویس گیرنده برای سرویس های وب Google Maps تحت مجوز Apache 2.0 مجوز دارند.
کتابخانه‌های سرویس گیرنده بسته‌بندی‌هایی برای سرویس‌های وب Google Maps هستند. خدمات وب Google Maps توسط شرایط خدمات پلتفرم Google Maps اداره می شود.
مهم : این کتابخانه ها تحت پوشش خط مشی استاندارد منسوخ شدن یا توافق نامه پشتیبانی Google نیستند .
کلیدهای API و شناسه مشتری
هر سرویس وب Google Maps به یک کلید API یا شناسه مشتری نیاز دارد. برای راهنمایی در مورد زمان استفاده از یک کلید API، زمان استفاده از شناسه مشتری، و نحوه دستیابی به کلید API یا شناسه مشتری، به راهنمای احراز هویت برای API مورد استفاده خود مراجعه کنید:
،
Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps، کتابخانه های سرویس گیرنده پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها برای دانلود و مشارکت در GitHub در دسترس هستند، جایی که دستورالعمل های نصب و کد نمونه را نیز خواهید یافت:
چرا از کتابخانه های مشتری استفاده کنیم؟
Java Client، Python Client، Go Client و Node.js Client برای خدمات Google Maps شما را قادر می سازد با سرویس های وب Google Maps در سرور خود کار کنید. آنها عملکرد API های زیر را در بر می گیرند:
علاوه بر عملکرد ارائه شده توسط این API ها، کتابخانه های سرویس گیرنده برخی از وظایف رایج را کمی آسان تر می کند.
- محدودیت نرخ خودکار به طور پیش فرض، درخواست ها با محدودیت نرخ مورد انتظار برای هر سرویس وب ارسال می شوند. می توانید محدودیت های سفارشی QPM را با
new GeoApiContext().setQueryRateLimit(qpm) ارائه دهید. - اگر API یک خطای
5xx ارسال کند، کتابخانه های سرویس گیرنده به طور خودکار هر درخواستی را دوباره امتحان می کنند. تلاش‌های مجدد از عقب‌نشینی نمایی استفاده می‌کند، که در صورت خرابی‌های متناوب کمک می‌کند. - احراز هویت آسان کتابخانه های سرویس گیرنده احراز هویت با کلید API آزادانه شما را آسان می کنند. مشتریان طرح ممتاز پلتفرم Google Maps می توانند از شناسه مشتری و راز خود استفاده کنند.
- POJO ها کتابخانه های جاوا اشیاء بومی را برای هر یک از پاسخ های API برمی گرداند. کتابخانه های پایتون ساختار را همانطور که از API دریافت می کند برمی گرداند.
- ناهمزمان یا همزمان همه درخواست‌ها از سبک تماس همزمان یا ناهمزمان پشتیبانی می‌کنند.
شرایط و ضوابط
کتابخانه های سرویس گیرنده برای سرویس های وب Google Maps تحت مجوز Apache 2.0 مجوز دارند.
کتابخانه‌های سرویس گیرنده بسته‌بندی‌هایی برای سرویس‌های وب Google Maps هستند. خدمات وب Google Maps توسط شرایط خدمات پلتفرم Google Maps اداره می شود.
مهم : این کتابخانه ها تحت پوشش خط مشی استاندارد منسوخ شدن یا توافق نامه پشتیبانی Google نیستند .
کلیدهای API و شناسه مشتری
هر سرویس وب Google Maps به یک کلید API یا شناسه مشتری نیاز دارد. برای راهنمایی در مورد زمان استفاده از یک کلید API، زمان استفاده از شناسه مشتری، و نحوه دستیابی به کلید API یا شناسه مشتری، به راهنمای احراز هویت برای API مورد استفاده خود مراجعه کنید:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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, simplify development with features such as automatic rate limiting, retry mechanisms, and easy authentication.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries provide synchronous and asynchronous calling styles while adhering to the Google Maps Platform Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eThey are not covered by Google's standard deprecation policy or support agreement and require an API key or client ID for usage, obtainable through API-specific authentication guides.\u003c/p\u003e\n"]]],["Community-supported Java, Python, Go, and Node.js client libraries for Google Maps Services are available on GitHub under the Apache 2.0 License. These clients wrap APIs like Address Validation, Directions, and Places, offering features such as automatic rate limiting, retry on failure, and easy authentication via API keys or client IDs. They facilitate server-side interaction with Google Maps web services. The libraries support both synchronous and asynchronous requests.\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)"]]
