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

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

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

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

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

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

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