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

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

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

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

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

קטגוריהפרטי מק"ט של מפותתמחור מק"טים
Essentials מק"ט: מפות דינמיות רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: תמונות סטטיות של Street View רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: Dynamic Street View רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: Elevation רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: Immersive Maps רשימת המחירים הראשית
רשימת המחירים בהודו
קטגוריהפרטי מק"ט של ספריית מקומות, Maps JavaScript API (חדש)תמחור מק"טים
Essentials SKU: Autocomplete Requests רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials SKU: Autocomplete Session Usage רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: המרת כתובות לקואורדינטות (geocoding) רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: Place Details Essentials (מזהים בלבד) רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: Place Details Essentials רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: הנחיות בסיסיות להתאמת תוכן לחיפוש Google (מזהים בלבד) רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: חיפוש בקרבת מקום Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: Place Details Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: חיפוש טקסט Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש בקרבת מקום Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: Place Details Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש טקסט Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש טקסט Enterprise + Atmosphere רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: תמונות בפרטי מקום רשימת המחירים הראשית
רשימת המחירים בהודו
קטגוריהפרטי מק"ט של ספריית מקומות, Maps JavaScript API (גרסה קודמת)תמחור מק"טים
Essentials מק"ט: השלמה אוטומטית – לכל בקשה רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials

SKU: Basic Data

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: חיפוש מקום - מזהה מקום בלבד רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials SKU: Place Details Essentials- ID Refresh רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: השלמה אוטומטית ללא Place Details – לכל סשן רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: חיפוש מקום

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: מקומות – חיפוש בקרבת מקום

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

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

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: פרטי מקומות

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise

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

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

רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise

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

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

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

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

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

  • החיוב על בקשות לחישוב מסלול הוא על כל בקשה.

  • חיוב על בקשות ל-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 לא צורכות מכסה בפרויקט בענן.

שינוי המכסה

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

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

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

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

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

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

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

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