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

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

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

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

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

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

קטגוריה	פרטי מק"ט של מפות	תמחור מק"טים
‫Essentials	מק"ט: מפות דינמיות	רשימת מחירים גלובלית רשימת מחירים בהודו
‫Essentials	מק"ט: תמונות סטטיות של Street View	רשימת מחירים גלובלית רשימת מחירים בהודו
Pro	מק"ט: Dynamic Street View	רשימת מחירים גלובלית רשימת מחירים בהודו
Pro	מק"ט: עלייה	רשימת מחירים גלובלית רשימת מחירים בהודו
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	מק"ט: חיפוש מקום חיובים נוספים: SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון להודו
Pro	מק"ט: מקומות – חיפוש בסביבה חיובים נוספים: SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	רשימת מחירים גלובלית רשימת מחירים בהודו
Pro	מק"ט: מקומות – חיפוש טקסט חיובים נוספים: SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון להודו
Pro	מק"ט: פרטי מקומות חיובים נוספים: SKU: Basic Data מק"ט: נתוני אנשי קשר מק"ט: נתוני אווירה	מחירון גלובלי מחירון להודו
‫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	מק"ט: Distance Matrix Advanced	רשימת מחירים גלובלית רשימת מחירים בהודו

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

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

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

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

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

• ‫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 כדי להפחית את העלויות שקשורות אליו.

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

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

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

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

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

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

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

שינוי המכסה

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

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

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

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

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

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

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

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

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

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

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

---