שימוש וחיובים ב-Maps JavaScript API

כדי לראות את תוכן העניינים של הדף הזה, לוחצים על סמל המידע info.

בקשות של Maps JavaScript API יוצרות קריאות למק"טים שונים בהתאם לסוג הבקשה: לדוגמה, טעינות של מפות מפעילות את המק"ט של מפות דינמיות, ותמונות פנורמיות מפעילות את המק"ט של Street View דינמי. התמחור של קריאות לספריית המקומות ב-Maps JavaScript API ולשירותי JavaScript אחרים הוא נפרד. למידע נוסף, עיינו בפרטי המק"טים וברשימות המחירים בטבלה הבאה.

פרטי המק"טים והתמחור של Maps JavaScript API

בטבלה הבאה מפורטים המק"טים של Maps JavaScript API בתשלום לפי שימוש והמחירים שלהם.

קטגוריהפרטי המק"טים של מפות Googleתמחור מק"טים
Essentials מק"ט: מפות דינמיות מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Static Street View מחירון גלובלי
מחירון בהודו
Pro מק"ט: Dynamic Street View מחירון גלובלי
מחירון בהודו
Pro מק"ט: Elevation מחירון גלובלי
מחירון בהודו
Pro מק"ט: מפות מודעות למיקום מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"ט של ספריית המקומות, Maps JavaScript API (חדש)תמחור מק"טים
Essentials מק"ט: Autocomplete Requests מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: שימוש בסשן של השלמה אוטומטית מחירון גלובלי
מחירון בהודו
Essentials מק"ט: המרת כתובות לקואורדינטות (geocoding) מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: Place Details Essentials (מזהים בלבד) מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Place Details Essentials מחירון גלובלי
מחירון בהודו
Essentials מק"ט: חיפוש טקסט Essentials (IDs Only) מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש בסביבה Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: Place Details Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש טקסט Pro מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט לארגונים מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט לארגונים + אווירה מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Photos מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"ט של ספריית המקומות, Maps JavaScript API (גרסה קודמת)תמחור מק"טים
Essentials מק"ט: Autocomplete – Per Request מחירון גלובלי
מחירון בהודו
Essentials מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן מחירון גלובלי
מחירון בהודו
Essentials

מק"ט: נתונים בסיסיים

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: Find Place – מזהה בלבד מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Place Details Essentials – רענון מזהה מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Query Autocomplete – לכל בקשה מחירון גלובלי
מחירון בהודו
Pro מק"ט: Autocomplete without Place Details – לכל סשן מחירון גלובלי
מחירון בהודו
Pro

מק"ט: Find Place

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Pro

מק"ט: Places – חיפוש בסביבה

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Pro

מק"ט: מקומות - חיפוש טקסט

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Pro

מק"ט: Places Details

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise

מק"ט: נתוני אווירה

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise

מק"ט: נתוני אנשי קשר

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Places Photos מחירון גלובלי
מחירון בהודו
קטגוריהPlaces UI Kitתמחור מק"טים
Essentials מק"ט: Places UI Kit Query מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Places UI Kit – השלמה אוטומטית לסשן מחירון גלובלי
מחירון בהודו
Pro ‫מק"ט: Places UI Kit (Advanced) מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"טים של Routes Libraryתמחור מק"טים
Essentials מק"ט: Routes: Compute Routes Essentials מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Routes: Compute Route Matrix Essentials מחירון גלובלי
מחירון בהודו
Pro מק"ט: Routes: Compute Routes Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: Routes: Compute Route Matrix Pro מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Routes: Compute Routes Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Routes: Compute Route Matrix Enterprise מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"טים של Routes API (הדור הקודם)תמחור מק"טים
Essentials מק"ט: מסלולים מחירון גלובלי
מחירון בהודו
Essentials מק"ט: מטריצת מרחקים מחירון גלובלי
מחירון בהודו
Pro מק"ט: Directions Advanced מחירון גלובלי
מחירון בהודו
Pro מק"ט: Distance Matrix Advanced מחירון גלובלי
מחירון בהודו

פרטי התמחור של ספריית המסלולים

לכל אחת מהמחלקות Route ו-RouteMatrix יש שלושה מק"טים שקובעים את עלות הבקשה. המק"ט שמשמש לקביעת העלות מבוסס על השירות שבו אתם משתמשים, מחלקה Route או מחלקה RouteMatrix, ועל התכונות שבהן אתם משתמשים בבקשה. לדוגמה:

  • בקשות Compute route מחויבות על כל בקשה.

  • החיוב על בקשות Compute route matrix הוא לפי ELEMENT שמוחזר מהבקשה. מספר הרכיבים הוא מספר נקודות המוצא כפול מספר היעדים. לדוגמה, אם בקשה מכילה שתי נקודות מוצא ושלושה יעדים, הבקשה תחויב על שישה רכיבים.

התכונות שבהן אתם משתמשים קובעות איזו קטגוריית מק"ט תחויב:

  • ‫Essentials: חיוב על בקשות שמשתמשות רק בתכונות בסיסיות, עם עד 10 נקודות ציון ביניים.

  • Pro: חיוב על בקשות שמשתמשות בתכונה מתקדמת, כמו משתני המסלול TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL.

  • Enterprise: חיוב על בקשות שמשתמשות בתכונה של Enterprise, כמו מסלול לרכב דו-גלגלי.

מגבלות השימוש הבאות חלות על JavaScript.

חישוב מסלולים

  • מגבלת קצב של 3,000 שאילתות לדקה.

  • המספר המקסימלי המותר של נקודות ציון ביניים לכל בקשת computeRoutes הוא 25.

חישוב מטריצת מסלולים

  • מגבלת הקצב היא 3,000 רכיבים לדקה, והיא מחושבת לפי מספר נקודות המוצא כפול מספר היעדים.

  • אפשר לציין עד 50 נקודות מוצא ויעדים באמצעות מזהה מקום או כתובת.

  • המספר המקסימלי המותר של רכיבים לכל בקשת computeRouteMatrix עם routingPreference שמוגדר כ-TRAFFIC_AWARE_OPTIMAL הוא 100.

  • המספר המקסימלי המותר של רכיבים לכל בקשת computeRouteMatrix עם travelMode שמוגדר כ-TRANSIT הוא 100.

  • אחרת, המספר המקסימלי המותר של רכיבים לכל בקשת computeRouteMatrix הוא 625.

מכסות ומגבלות שימוש

כדי לבדוק ולנהל את המכסות ומכסות השימוש ב-Maps JavaScript API, קראו את המאמר מכסות והתראות על הגעה למכסה.

מכסות לטעינת מפות

המכסות הבאות חלות על טעינות של מפות דו-ממדיות ותלת-ממדיות ב-Maps JavaScript API:

  • ‫30,000 טעינות מפה לדקה לכל פרויקט
  • 300 טעינות מפה לדקה לכל כתובת IP

מגבלות השימוש ב-Places UI Kit

על Places UI Kit חלות מגבלות השימוש הבאות:

  • שאילתת Places UI Kit: בקשות מהרכיבים Place Details וחיפוש מקומות מוגבלות ל-6,000 שאילתות לדקה לכל פרויקט.

  • סשן של Places UI Kit: בקשות מהרכיב Autocomplete מוגבלות ל-6,000 שאילתות לדקה לכל פרויקט.

הבקשות הבסיסיות ל-Places API ול-Geocoding API לא מנצלות את המכסה בפרויקט בענן שלכם.

אסטרטגיות חסכוניות לשימוש ב-Places API

בקטע הזה מפורטות דרכים לאופטימיזציה של השימוש ולהפחתת העלויות שקשורות ל-Places API.

שימוש במסכות שדות

שימוש במסכת שדות מבטיח שלא תבקשו נתונים מיותרים, וכך עוזר לצמצם את זמן האחזור ואת החיובים.

בבקשות של פרטי מקום (חדש), חיפוש בסביבה (חדש) וחיפוש טקסט (חדש), צריך להשתמש במסכת שדות כדי לציין את רשימת השדות שיוחזרו בתגובה.

לאחר מכן, החיוב מתבצע לפי המק"ט הגבוה ביותר שרלוונטי לבקשה. לדוגמה, אם תבחרו שדות גם מהמק"ט Essentials וגם מהמק"ט Pro, תחויבו לפי המק"ט Pro.

שימוש בתמחור לפי סשן עם Place Details (New)

אם לאפליקציות שלכם יש נפח קריאות חודשי של 100,001 עד 500,000 או יותר, או אם המשתמשים שולחים יותר מ-12 בקשות להשלמה אוטומטית בכל סשן, Google ממליצה להשתמש בסשנים עם Autocomplete (New). הסשנים עוזרים לפשט את התמחור ומספקים מודל תמחור עקבי לשימוש עם Autocomplete (New).

מידע נוסף זמין במאמר השלמה אוטומטית (חדשה) ותמחור לפי סשן.

שינוי המכסה

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

כדי לשנות ערך של מכסה ב-API:

  1. במסוף Cloud, נכנסים לדף Google Maps Platform > Quotas.
  2. בוחרים את ה-API שרוצים לשנות את המכסה שלו.
  3. מזהים את ערך המכסה שרוצים לשנות ומסמנים את התיבה שלידו.
  4. לוחצים על Edit, מזינים ערך חדש למכסה ולוחצים על Submit request.

הצגה של בקשות להגדלת מכסות

כדי לראות את כל הבקשות להגדלת מכסות, כולל בקשות קודמות ובקשות בהמתנה, מבצעים את השלבים הבאים:

  1. במסוף Cloud, נכנסים לדף Google Maps Platform > Quotas.
  2. בוחרים את ה-API שרוצים לראות את הבקשה להגדלת המכסה שלו.
  3. לוחצים על Increase Requests.

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

לפרטים מלאים על השימוש המותר, עיינו בסעיף 'הגבלות על הרישיון' בתנאים ובהגבלות של Google Maps Platform.