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

תזכורת: כדי להשתמש ב-Maps JavaScript API, צריך להפעיל את החיוב בכל אחד מהפרויקטים ולכלול מפתח API או אסימון OAuth בכל הבקשות ל-API או ל-SDK.

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

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

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

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

קטגוריה	פרטי המק"ט של מפות Google	תמחור מק"טים
Essentials	מק"ט: מפות דינמיות	מחירון גלובלי מחירון להודו
‫Essentials	מק"ט: Static Street View	מחירון גלובלי מחירון בהודו
Pro	SKU: Dynamic Street View	מחירון גלובלי מחירון בהודו
Pro	מק"ט: Elevation	מחירון גלובלי מחירון להודו
Pro	מק"ט: מפות מודעות למיקום	מחירון גלובלי מחירון בהודו
קטגוריה	פרטי המק"ט של ספריית מקומות, Maps JavaScript API (חדש)	תמחור מק"טים
‫Essentials	SKU: Autocomplete Requests	מחירון גלובלי מחירון בהודו
‫Essentials	‫מק"ט: שימוש בסשן של השלמה אוטומטית	מחירון גלובלי מחירון בהודו
‫Essentials	מק"ט: המרת כתובות לקואורדינטות (geocoding)	מחירון גלובלי מחירון להודו
Essentials	מק"ט: Place Details Essentials (מזהים בלבד)	מחירון גלובלי מחירון בהודו
Essentials	מק"ט: Place Details Essentials	מחירון גלובלי מחירון בהודו
Essentials	SKU: Text Search 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	מק"ט: חיפוש טקסט Enterprise + Atmosphere	מחירון גלובלי מחירון בהודו
Enterprise	מק"ט: תמונות בפרטי המקום	מחירון גלובלי מחירון בהודו
קטגוריה	פרטי מק"ט של Places Library, Maps JavaScript API (גרסה קודמת)	תמחור מק"טים
Essentials	SKU: Autocomplete - Per Request	מחירון גלובלי מחירון בהודו
Essentials	מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן	מחירון גלובלי מחירון בהודו
Essentials	‫SKU: Basic Data חיובים נוספים: מק"ט: פרטי מקומות מק"ט: Find Place מק"ט: מקומות – חיפוש בסביבה מק"ט: מקומות – חיפוש טקסט	מחירון גלובלי מחירון בהודו
Essentials	‫מק"ט: Find Place – מזהה בלבד	מחירון גלובלי מחירון בהודו
‫Essentials	מק"ט: Place Details Essentials – רענון מזהה	מחירון גלובלי מחירון בהודו
Essentials	‫SKU: Query Autocomplete - Per Request	מחירון גלובלי מחירון בהודו
Pro	מק"ט: השלמה אוטומטית ללא Places Details – לכל סשן	מחירון גלובלי מחירון בהודו
Pro	‫SKU: Find Place חיובים נוספים: ‫SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון בהודו
Pro	SKU: Places - Nearby Search חיובים נוספים: מק"ט: נתונים בסיסיים מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון בהודו
Pro	מק"ט: מקומות – חיפוש טקסט חיובים נוספים: מק"ט: נתונים בסיסיים מק"ט: נתוני אנשי קשר SKU: Atmosphere Data	מחירון גלובלי מחירון בהודו
Pro	מק"ט: פרטי מקומות חיובים נוספים: ‫SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: נתוני אווירה חיובים נוספים: מק"ט: פרטי מקומות ‫SKU: Find Place SKU: Places - Nearby Search מק"ט: מקומות – חיפוש טקסט	מחירון גלובלי מחירון בהודו
Enterprise	מק"ט: נתוני אנשי קשר חיובים נוספים: מק"ט: פרטי מקומות מק"ט: Find Place SKU: Places - Nearby Search מק"ט: Places – חיפוש טקסט	מחירון גלובלי מחירון להודו
‫Enterprise	SKU: Places Photos	מחירון גלובלי מחירון להודו
קטגוריה	Places UI Kit	תמחור מק"טים
Essentials	‫SKU: Places UI Kit Query	מחירון גלובלי מחירון בהודו
Essentials	SKU: Places UI Kit - Autocomplete Per Session	מחירון גלובלי מחירון בהודו
Pro	‫מק"ט: Places UI Kit (Advanced)	מחירון גלובלי מחירון בהודו
קטגוריה	פרטי המק"ט של ספריית המסלולים	תמחור מק"טים
Essentials	מק"ט: Routes: Compute Routes Essentials	מחירון גלובלי מחירון בהודו
Essentials	מק"ט: Routes: Compute Route Matrix Essentials	רשימת מחירים גלובלית רשימת מחירים בהודו
Pro	מק"ט: Routes: Compute Routes Pro	מחירון גלובלי מחירון בהודו
Pro	מק"ט: Routes: Compute Route Matrix Pro	מחירון גלובלי מחירון בהודו
Enterprise	מק"ט: מסלולים: חישוב מסלולים לארגונים	רשימת מחירים גלובלית רשימת מחירים בהודו
Enterprise	מק"ט: Routes: Compute Route Matrix Enterprise	מחירון גלובלי מחירון בהודו
קטגוריה	פרטי המק"טים של Routes API (הדור הקודם)	תמחור מק"טים
‫Essentials	מק"ט: מסלולים	מחירון גלובלי מחירון בהודו
Essentials	מק"ט: מטריצת מרחקים	מחירון גלובלי מחירון להודו
Pro	מק"ט: Directions Advanced	מחירון גלובלי מחירון בהודו
Pro	מק"ט: Distance Matrix Advanced	מחירון גלובלי מחירון בהודו

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

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

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

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

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

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

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

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

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

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

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

שינוי המכסה

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

חשוב: כדי להבין איך הגדלת המכסה יכולה להשפיע על החשבון, כדאי לעיין במחשבון עלויות.

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

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

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

חשוב: כדי לראות את הבקשות להגדלת המכסות, צריך שיהיו לכם הרשאות IAM מתאימות.

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

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

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

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

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

---