המוצר או התכונה האלה בסטטוס 'קודם'. מידע נוסף על השלב 'דור קודם' ועל המעבר מדור קודם לשירותים חדשים זמין במאמר
מוצרים ותכונות מדור קודם.
ספריות לקוח לשירותי האינטרנט של מפות Google
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ספריות הלקוח של Java, Python, Go ו-Node.js לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם ולתרום להם ב-GitHub, שם תמצאו גם הוראות התקנה וקוד לדוגמה:
למה כדאי להשתמש בספריות הלקוח?
לקוח Java, לקוח Python, לקוח Go ו-Node.js לשירותי מפות Google מאפשרים לכם לעבוד עם שירותי האינטרנט של מפות Google בשרת.
הם עוטפים את הפונקציונליות של ממשקי ה-API הבאים:
בנוסף לפונקציונליות שמספקים ממשקי ה-API האלה, ספריות הלקוח עוזרות לבצע משימות נפוצות בקלות רבה יותר.
- הגבלת קצב אוטומטית כברירת מחדל, הבקשות נשלחות לפי מגבלת הקצב הצפויה לכל שירות אינטרנט. אפשר לציין מגבלות QPM בהתאמה אישית באמצעות
new GeoApiContext().setQueryRateLimit(qpm).
- ניסיון חוזר במקרה של כשל: ספריות הלקוח ינסו שוב באופן אוטומטי כל בקשה אם ה-API שולח שגיאה מסוג
5xx. בניסיונות החוזרים נעשה שימוש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff), שעוזרת במקרה של כשלים זמניים.
- אימות קל ספריות הלקוח מאפשרות לבצע אימות בקלות באמצעות מפתח ה-API שזמין בחינם. לקוחות עם מינוי Premium לפלטפורמה של מפות Google יכולים להשתמש במזהה הלקוח והסוד שלהם.
- POJO: ספריות Java מחזירות אובייקטים מקומיים לכל אחת מהתגובות של ה-API. ספריות Python מחזירות את המבנה כפי שהוא מתקבל מה-API.
- אסינכרוני או סינכרוני כל הבקשות תומכות בסגנון קריאה אסינכרוני או סינכרוני.
תנאים והגבלות
ספריות הלקוח של שירותי האינטרנט של מפות Google מורשות במסגרת רישיון Apache 2.0.
ספריות הלקוח הן חבילות של שירותי האינטרנט של מפות Google. שירותי האינטרנט של מפות Google כפופים לתנאים ולהגבלות של פלטפורמת מפות Google.
חשוב: הספריות האלה לא מכוסות במדיניות הרגילה של Google בנושא הוצאה משימוש או בהסכם התמיכה.
מפתחות API ומזהי לקוחות
לכל שירות אינטרנט של מפות Google נדרש מפתח API או מזהה לקוח. במדריך לאימות של ממשק ה-API שבו אתם משתמשים מוסבר מתי כדאי להשתמש במפתח API, מתי כדאי להשתמש במזהה לקוח ואיך מקבלים את מפתח ה-API או את מזהה הלקוח:
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\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 Geocoding, Directions, 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\u003eThe client libraries are governed by the Google Maps Platform Terms of Service, but they 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 to help users obtain and use them.\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)"]]
