ספריות לקוח לשירותי האינטרנט של מפות 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 שולח שגיאה ברמה 500, באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff) כדי לעזור בטיפול בכשלים לסירוגין.
  • אימות פשוט: מאפשר לכם לבצע אימות באמצעות מפתח API, או באמצעות מזהה לקוח וסוד ללקוחות Google Maps Platform Premium Plan.
  • אובייקטים פשוטים של Java‏ (POJO): מחזירים אובייקטים של Java עם סוג החזרה לכל תגובה מה-API בספריית Java, ואילו ספריית Python מחזירה את מבנה התגובה ישירות מה-API.
  • קריאות אסינכרוניות או סינכרוניות: תמיכה בסגנונות קריאה סינכרוניים ואסינכרוניים לכל הבקשות.

תנאים והגבלות

ספריות הלקוח של שירותי האינטרנט של מפות Google פועלות ברישיון Apache 2.0.

ספריות הלקוח הן מעטפות של שירותי האינטרנט של הפלטפורמה של מפות Google, שכפופים לתנאים ולהגבלות של הפלטפורמה של מפות Google.

מפתחות API ומזהי לקוח

לכל שירות אינטרנט של מפות Google נדרש מפתח API או מזהה לקוח. למידע נוסף על מתי להשתמש במפתח API, מתי להשתמש במזהה לקוח ואיך לקבל את מפתח ה-API או את מזהה הלקוח, עיינו במדריך האימות של ה-API שבו אתם משתמשים: