ספריות לקוח לשירותי האינטרנט של מפות 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 שזמין בחינם. לקוחות עם תוכנית פרימיום של Google Maps Platform יכולים להשתמש במזהה הלקוח ובסוד הלקוח שלהם.
  • POJOs ספריות Java מחזירות אובייקטים מקוריים לכל אחת מהתגובות מה-API. ספריות Python מחזירות את המבנה כפי שהוא מתקבל מה-API.
  • אסינכרוני או סינכרוני כל הבקשות תומכות בסגנון קריאה סינכרוני או אסינכרוני.

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

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

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

חשוב: הספריות האלה לא נכללות במדיניות ההוצאה משימוש או בהסכם התמיכה הרגילים של Google.

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

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