ספריות הלקוח של Java, Python, Go ו-Node.js לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם ולתרום להם ב-GitHub, שם תמצאו גם הוראות התקנה וקוד לדוגמה:
- Java Client for Google Maps Services
- לקוח Python לשירותי מפות Google
- Go Client לשירותי מפות Google
- לקוח Node.js לשירותי מפות Google
- לקוח Objective-C לשירותי מפות Google
- Google API Client – מדריך למפתחים ב-Java
למה כדאי להשתמש בספריות הלקוח?
לקוח Java, לקוח Python, לקוח Go ו-Node.js לשירותי מפות Google מאפשרים לכם לעבוד עם שירותי האינטרנט של מפות Google בשרת. הם עוטפים את הפונקציונליות של ממשקי ה-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.
- POJO: ספריות Java מחזירות אובייקטים מקומיים לכל אחת מהתגובות של ה-API. ספריות Python מחזירות את המבנה כפי שהוא מתקבל מה-API.
- אסינכרוני או סינכרוני כל הבקשות תומכות בסגנון קריאה אסינכרוני או סינכרוני.
תנאים והגבלות
ספריות הלקוח של שירותי האינטרנט של מפות Google מורשות במסגרת רישיון Apache 2.0.
ספריות הלקוח הן חבילות של שירותי האינטרנט של מפות Google. שירותי האינטרנט של מפות Google כפופים לתנאים ולהגבלות של פלטפורמת מפות Google.
חשוב: הספריות האלה לא מכוסות במדיניות הרגילה של Google בנושא הוצאה משימוש או בהסכם התמיכה.