ספריות הלקוח של Java, Python, Go ו-Node.js לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם ולתרום להם ב-GitHub, שם תמצאו גם הוראות התקנה וקוד לדוגמה:
- Java Client for Google Maps Services
- לקוח Python לשירותי מפות Google
- Go Client לשירותי מפות Google
- לקוח Node.js לשירותי מפות Google
למה כדאי להשתמש בספריות הלקוח?
לקוח Java, לקוח Python, לקוח Go ו-Node.js לשירותי מפות Google מאפשרים לכם לעבוד עם שירותי האינטרנט של מפות Google בשרת. הם עוטפים את הפונקציונליות של ממשקי ה-API הבאים:
- Address Validation API
- Directions API (ממשק מדור קודם)
- Distance Matrix API (ממשק API מדור קודם)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone 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 או את מזהה הלקוח: