לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google הם ספריות לקוח שנתמכות על ידי הקהילה, ומבוססות על קוד פתוח במסגרת רישיון Apache 2.0. הם זמינים להורדה ולהוספת תוכן ב-GitHub, שם תוכלו גם למצוא הוראות התקנה וקוד לדוגמה:
- לקוח Java לשירותי מפות Google
- לקוח Python לשירותי מפות Google
- Go Client לשירותי מפות Google
- לקוח Node.js לשירותי מפות Google
למה כדאי להשתמש בספריות הלקוח?
לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google מאפשרים לעבוד עם שירותי האינטרנט של מפות Google בשרת שלכם. הם כוללים את הפונקציונליות של ממשקי ה-API הבאים:
- ממשק API לאימות כתובות
- API של המסלול
- מרחק API מטריקס
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API
בנוסף לפונקציונליות שמספקים ממשקי ה-API האלה, ספריות הלקוח מקלות קצת על חלק מהמשימות הנפוצות.
- הגבלת קצב של יצירת בקשות כברירת מחדל, הבקשות נשלחות במגבלת הקצב הצפויה לכל שירות אינטרנט. אפשר להגדיר מגבלות QPS מותאמות אישית באמצעות
new GeoApiContext().setQueryRateLimit(qps)
. - ניסיון חוזר כשנכשל ספריות הלקוח מנסות שוב
באופן אוטומטי בקשות כלשהן אם ה-API שולח את הודעת השגיאה
5xx
. בניסיונות החוזרים, המערכת משתמשת בהשהיה מעריכית לצורך השהיה מעריכית, שעוזרת במקרים של כשלים לסירוגין. - אימות קל: ספריות הלקוח מקלות על האימות באמצעות מפתח ה-API שזמין בחינם. לקוחות עם תוכנית הפרימיום של הפלטפורמה של מפות Google יכולים להשתמש במזהה הלקוח ובסוד שלהם.
- POJOs ספריות ה-Java מחזירות אובייקטים מקוריים לכל אחת מהתגובות של ה-API. ספריות Python מחזירות את המבנה כפי שהוא מתקבל מה-API.
- אסינכרוני או סינכרוני כל הבקשות תומכות בסגנון התקשרות סינכרוני או אסינכרוני.
תנאים והגבלות
ספריות הלקוח של שירותי האינטרנט של מפות Google מותקנות במסגרת רישיון Apache 2.0.
ספריות הלקוח הן רכיבי wrapper של שירותי האינטרנט של מפות Google. שירותי האינטרנט של מפות Google כפופים לתנאים ולהגבלות של הפלטפורמה של מפות Google.
חשוב: הספריות האלה לא נכללות במדיניות הרגילה של Google בנושא הוצאה משימוש או בהסכם התמיכה.
מפתחות API ומזהי לקוח
לכל שירות אינטרנט של מפות Google נדרש מפתח API או מזהה לקוח. כדי להבין מתי להשתמש במפתח API, מתי להשתמש במזהה לקוח ואיך להשיג את מפתח ה-API או מזהה הלקוח שלכם, אפשר לעיין במדריך האימות לממשק ה-API שבו אתם משתמשים: