שימוש ב-API של JavaScript במפות Google

ה-API ל-JavaScript של מפות Google מבוסס על מודל תמחור מסוג 'תשלום לפי שימוש'. בקשות של Maps JavaScript API יוצרות קריאות לשני מק"טים שונים בהתאם לסוג הבקשה: טעינת מפה או פנורמה. קריאות ל-Places Library, Maps JavaScript API ולשירותי JavaScript אחרים מתומחרות בנפרד ממק"טים מקוריים של JavaScript. לצד התנאים וההגבלות הכוללים של Google, יש מגבלות שימוש ספציפיות ל-Maps JavaScript API. נהל את העלויות והשימוש שלך באמצעות הכלים הזמינים במסוף Google Cloud.

אופן החיוב של Maps JavaScript API

ה-API ל-JavaScript של מפות Google מבוסס על מודל התמחור לפי תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע לפי מק"טים. השימוש מתבצע לכל מק"ט, ולכל API או SDK יכול להיות יותר ממק"ט מוצר אחד. העלות מחושבת לפי

שימוש במק"ט × מחיר לכל שימוש

אפשר להשתמש במחשבון התמחור והשימוש כדי להעריך את עלות השימוש ל-API או ל-SDK. מק"טים שעומדים בדרישות הפלטפורמה של מפות Google יכולים לקבל בכל חודש זיכוי בסך 200 $USD לכל חשבון לחיוב. הזיכוי הזה מוחל באופן אוטומטי על המק"טים שעומדים בדרישות1.

תמחור עבור Maps JavaScript API

מק"ט: מפות דינמיות

אפליקציה שמציגה מפה שנטענה עם או בלי מזהה מפה באמצעות Maps JavaScript API, או מפה שנטען בה מזהה מפה ומשתמשת ב-SDK של מפות Google ל-Android או ב-SDK של מפות ל-iOS.

טווח נפח חודשי
(מחיר לכל טעינת מפה)
0-100,000 100,001–500,000 יותר מ-500,000
0.007 USD לכל
(7.00 USD לכל 1000)		 0.0056$ לכל
(5.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

מק"ט: Street View דינמי

החיוב על תמונות פנורמיות ב-Street View וטעינת מפות מתבצע עכשיו בנפרד. פנורמה דינמית של Street View מחויבת על כל יצירה של אובייקט פנורמה ב-Maps JavaScript API, מפות SDK עבור Android, SDK של מפות עבור iOS.

טווח נפח חודשי
(מחיר ל-PANORAMA)
0-100,000 100,001–500,000 יותר מ-500,000
0.014 USD לכל
(14.00 USD לכל 1000)		 0.0112 USD לכל
(11.20 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מתרחשת יצירה של אובייקט פנורמה:

תמחור עבור ספריית מקומות, Maps JavaScript API

מק"ט: בקשות להשלמה אוטומטית

אנחנו מחייבים את המק"ט להשלמה אוטומטית של בקשות על כל בקשה ל-API של ההשלמה האוטומטית (חדש) שלא כוללת אסימון סשן.

החיוב יתבצע גם אם משתמשים באסימוני סשן ואם:

  • מסיימים את הסשנים באמצעות בקשה אחת לפרטי המקום (חדש) שמבקשת מכם שדות כלשהם שהוגדרו ב-SKU: Place Details (Location בלבד).
    • כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות מק"ט: בקשות להשלמה אוטומטית.
    • החיוב על כל בקשה נוספת להשלמה אוטומטית (חדשה) מתבצע באמצעות מק"ט: שימוש בסשן בהשלמה אוטומטית.
  • אפשר לעזוב את הסשן או לסיים את הסשן על ידי ביצוע שיחה למק"ט: פרטי מקום (מזהים בלבד). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשה) יחויבו באמצעות מק"ט: בקשות להשלמה אוטומטית.
טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00283 USD לכל
(2.83 USD ל-1000)		 0.00227 USD לכל
(2.27 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: שימוש בהשלמה אוטומטית של סשן

מתבצע חיוב במק"ט השלמה אוטומטית של סשן על כל בקשה ל-API של ההשלמה האוטומטית (חדש) שכוללת אסימון סשן.

החיוב על מק"ט זה מתבצע בתרחישים הבאים:

  • ההשלמה האוטומטית בסשן הסתיימה באמצעות קריאה למק"ט: פרטי מקום (מיקום בלבד):

    • כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות מק"ט: בקשות להשלמה אוטומטית.
    • החיוב על כל בקשה נוספת להשלמה אוטומטית (חדשה) מתבצע באמצעות מק"ט: שימוש בסשן בהשלמה אוטומטית.

  • תכונת ההשלמה האוטומטית הסתיימה עם קריאה למק"ט: פרטי מקום (בסיסי, מתקדם או מועדף).

    שיחה עם 'פרטי מקום' שמבקשת כל שדה ממק"ט: פרטי מקום (בסיסי, מתקדם או מועדפים) מחויבת במק"ט: פרטי מקום (מועדף).

  • הסשן של ההשלמה האוטומטית הסתיים עם קריאה ל-SKU: Preferred Validation Preferred.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)

מק"ט: פרטי המקום (מזהים בלבד)

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

ספריית מקומות, Maps JavaScript API: id, photos

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)

מק"ט: פרטי המקום (מיקום בלבד)

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

ספריית מקומות, Maps JavaScript API: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, types, viewport

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.005$ לכל
(5.00 USD לכל 1000)		 0.004 USD לכל
(4.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: פרטי המקום (בסיסי)

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

Places Library, Maps JavaScript API: accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, primaryTypeDisplayName, svgIconMaskURI, types, utcOffsetMinutes

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.0170 USD לכל
(17.00 USD לכל 1000)		 0.0136$ לכל
(13.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: פרטי המקום (מתקדם)

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

ספריית מקומות, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.020 USD לכל
(20.00 USD לכל 1000)		 0.016 USD לכל
(16.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: פרטי המקום (מועדף)

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

Places Library, Maps JavaScript API: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, hasTakeoutservesWine, hasTakeoutservesBeer

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.025 USD לכל
(25.00 USD לכל 1000)		 0.020 USD לכל
(20.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: חיפוש בקרבת מקום (בסיסי)

באמצעות אנונימיזציה של שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:

Places Library, Maps JavaScript API: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, id, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewportutcOffsetMinutes, {17/

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.032 USD לכל
(32.00 USD לכל 1000)		 0.0256$ לכל
(25.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: חיפוש בקרבת מקום (מתקדם)

באמצעות אנונימיזציה של שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:

ספריית מקומות, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.035$ לכל
(35.00 USD לכל 1000)		 0.028 USD לכל
(28.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: חיפוש בקרבת מקום (מועדף)

באמצעות אנונימיזציה של שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:

Places Library, Maps JavaScript API: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, hasTakeoutservesWine, hasTakeoutservesBeer

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.040 USD לכל
(40.00 USD לכל 1000)		 0.032 USD לכל
(32.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: חיפוש טקסט (מזהה בלבד)

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

ספריית מקומות, Maps JavaScript API: id

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.0 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)

מק"ט: חיפוש טקסט (בסיסי)

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

Places Library, Maps JavaScript API: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, location, photos, plusCode, svgIconMaskURI, types, utcOffsetMinutes, viewport

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.032 USD לכל
(32.00 USD לכל 1000)		 0.0256$ לכל
(25.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: Text Search (מתקדם)

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

ספריית מקומות, Maps JavaScript API: internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, userRatingCount, websiteUri

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.035$ לכל
(35.00 USD לכל 1000)		 0.028 USD לכל
(28.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: חיפוש טקסט (מועדף)

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

Places Library, Maps JavaScript API: hasCurbsidePickup, hasDelivery, hasDineIn, editorialSummary, parkingOptions, paymentOptions, priceLevel, isReservable, reviews, servesBeer, servesBreakfast, servesBrunch, servesDinner, servesLunch, servesVegetarianFood, servesWine, hasTakeoutservesWine, hasTakeoutservesBeer

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.040 USD לכל
(40.00 USD לכל 1000)		 0.032 USD לכל
(32.00 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: תמונה של המקום

המערכת מחייבת את המק"ט של תמונת מקום על כל בקשה ל-API.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.007 USD לכל
(7.00 USD לכל 1000)		 0.0056$ לכל
(5.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מידע על סשנים של השלמה אוטומטית

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

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

ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-API הבאים:

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

הבקשות להשלמה אוטומטית והבקשות לפרטי מקומות באמצעות סשנים מחויבות במק"טים שונים.

מידע על מק"טים של נתוני מקומות

שלושת המק"טים של נתוני מקומות הם: נתונים בסיסיים, נתונים של אנשי קשר ונתוני אטמוספרה.

מק"ט אחד או יותר של נתונים מופעל עבור:

  • Android: כל בקשה אל fetchPlace() או אל findCurrentPlace()
  • iOS: כל קריאה אל fetchPlaceFromPlaceID: או אל findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • שירות אינטרנט: כל בקשת 'מקומות' בהתאם לשדות שצוינו בבקשה

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

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

הקריאות האלה לממשקי ה-API של מקומות Google לא תומכות בציון השדות המוחזרים. הקריאות האלה תמיד מחזירות את כל נתוני המקומות, ומחייבות את שלושת המק"טים של נתוני מקומות בנוסף לחיוב עבור כל בקשת API:

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

באמצעות פרמטר השדות בבקשה 'פרטי מקום' או 'חיפוש מקום' אפשר להגביל את התגובה רק לשדות שצוינו. השדות בקטגוריה Basic נכללים בעלות הבסיס של הבקשה להוספת מקומות ולא כוללים חיוב נוסף. המק"ט של Basic Data מופעל כשנשלחת בקשה לאחד מהשדות הבאים:

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET או Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes, או GMSPlaceFieldViewport
  • שירות אינטרנט: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity או wheelchair_accessible_entrance
טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
עלות של בקשת מקומות
+ 0.00 USD		 עלות של בקשת מקומות
+ 0.00 USD		 עלות של בקשת מקומות
+ 0.00 USD

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

באמצעות הפרמטרים של השדות ב'פרטי מקום' או בבקשת 'חיפוש מקום' לשירותי אינטרנט, או מערך של ערכי Place.Field ל-Android או ל-iOS, אפשר להגביל את התגובה רק לשדות שצוינו. השימוש בשדות בקטגוריה Contact כרוך בתשלום נוסף. המק"ט של Contact Data מופעל כשנשלחת בקשה לאחד מהשדות הבאים:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS או Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber או GMSPlaceFieldWebsite
  • שירות אינטרנט: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours או website
טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
עלות של בקשת מקומות
+ 0.003 USD לכל אחד
(+ 3.00 USD ל-1,000)		 העלות של בקשת מקומות
+ 0.0024 USD לכל אחד
(+ 2.40 USD ל-1,000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

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

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.RESERVABLE, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE,Place.Field.TAKEOUT או Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch או GMSPlaceFieldServesVegetarianFood.
  • JavaScript: הצגת שדות (פרטי מקום)
  • שירות אינטרנט: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout או user_ratings_total.
טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
עלות של בקשת מקומות
+ 0.005$ לכל אחד
(+ 5.00$ לכל 1,000)		 עלות של בקשת מקומות
+ 0.004$ לכל אחד
(+ 4.00 USD ל-1,000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: השלמה אוטומטית – לפי בקשה

המק"ט השלמה אוטומטית – לכל בקשה מחויב על כל הקריאות או הבקשות הבאות שלא כוללות אסימון סשן:

שיחות שמקורן בפעילות לא חוקית של השלמה אוטומטית (למשל, סשן שנעשה בו שימוש חוזר באסימון סשן) מחויבות גם היא בהשלמה אוטומטית – לפי מק"ט.

ייתכן שתחויבו על ידי השלמה אוטומטית של בקשות מהווידג'ט להשלמה אוטומטית של מקומות מהווידג'ט להשלמה אוטומטית של מקומות במפות Google. במקרה של הפעלות לא חוקיות של השלמה אוטומטית, ייתכן שתחויבו בהשלמה אוטומטית לפי מק"ט. זה עשוי לקרות כאשר משתמש מקליד מספר כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט ולא תמיד בוחר בחיזוי של השלמה אוטומטית.

טווח נפח חודשי
(מחיר לבקשה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00283 USD לכל
(2.83 USD ל-1000)		 0.00227 USD לכל
(2.27 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן

המק"ט השלמה אוטומטית ללא פרטי מקום – לכל סשן מחויב על סשן השלמה אוטומטית שלא כולל בקשה לפרטי מקום (כמה דקות מתחילת הסשן).

טווח נפח חודשי
(מחיר לכל הפעלה)
0-100,000 100,001–500,000 יותר מ-500,000
0.017 USD לכל
(17.00 USD לכל 1000)		 0.0136$ לכל
(13.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

דוגמה

אם האפליקציה מעבירה את שתי הקריאות האלה לסשן אחד:

Android

iOS

שירות אינטרנט

בדף החשבון, המק"ט יופיע ברשימה (כשמציגים את החיוב לפי מק"ט):

  • השלמה אוטומטית ללא פרטי מקום – לכל ביקור (מחיר החל מ-0.017 דולר ארה"ב לסשן)

מק"ט: השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן

הערך של השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן מחויב על סשן של השלמה אוטומטית שכולל כל אחד מהפרטים הבאים:

  • Android: שיחה אל fetchPlace()
  • iOS: שיחה אל fetchPlaceFromPlaceID:
  • שירות אינטרנט: בקשה לפרטי מקום

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

בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספירה) – בהתאם לשדות שצוינו בבקשה.

אם לא תציינו שדות בבקשת פרטי המקום, כל המק"טים של הנתונים יופעלו (בסיסי, איש קשר ואטמוספירה).

בקשות לרענון של מזהה פרטי מקום (בקשות שמציינות רק את השדה place_id) במהלך סשן של ההשלמה האוטומטית, מחויבות כ-SKU: השלמה אוטומטית ללא פרטי מקום – לכל סשן.

טווח נפח חודשי
(מחיר לכל הפעלה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

אם האפליקציה מנפיקה את שלוש הקריאות הבאות באותה פעילות באתר:

Android

iOS

שירות אינטרנט

בחשבון יופיעו המק"טים הבאים (כשמציגים את החיוב לפי מק"ט):

  • השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן (בחיוב בסך 0.00 ש"ח)
  • פרטי המקום (מחיר החל מ-0.017 USD לסשן)
  • נתונים בסיסיים (חיוב בסך 0.00 USD)

מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה

מק"ט מסוג השלמה אוטומטית של שאילתה – לכל בקשה מחויב על כל בקשה כדי:

טווח נפח חודשי
(מחיר לבקשה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00283 USD לכל
(2.83 USD ל-1000)		 0.00227 USD לכל
(2.27 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

מק"ט: פרטי המקום

שיחות בפרטי מקום מחויבות באופן הבא:

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.017 USD לכל
(17.00 USD לכל 1000)		 0.0136$ לכל
(13.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

המק"ט של פרטי מקום נוצר מממשקי ה-API הבאים:

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

קריאה או בקשה של פרטי מקום יוצרים גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספירה), בהתאם לשדות שצוינו בשיחה או בבקשה. אם ציינתם את השדות NO בשיחה או בבקשה של פרטי המקום, יופעלו כל המק"טים של הנתונים, והחיוב יתבצע על השיחה או הבקשה בפרטי המקומות, בתוספת העלות של כל הנתונים.

דוגמאות

  1. מבצעים אחת מהשיחות או הבקשות הבאות:
    • בנייד: אפשר לקרוא ל-fetchPlace() ב-Android או ל-fetchPlaceFromPlaceID: ב-iOS, ולציין רק את השדה ADDRESS
    • Web API או Web API: שולחים בקשה לפרטי המקום ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address)
    המק"טים האלה יופיעו בחשבון (בהצגת החיוב לפי מק"ט):
    • פרטי המקום (מחיר החל מ-0.017 USD לסשן)
    • נתונים בסיסיים (חיוב בסך 0.00 USD)
  2. מבצעים אחת מהשיחות או הבקשות הבאות:
    • בנייד: אפשר לקרוא ל-fetchPlace() ב-Android או ל-fetchPlaceFromPlaceID: ב-iOS, ולציין רק את השדה PHONE_NUMBER
    • Web API או Web API: יש לשלוח בקשה לפרטי מקום ולציין את שדה מספר הטלפון: getPlaceDetails(fields: formatted_phone_number)
    המק"טים האלה יופיעו בחשבון (בהצגת החיוב לפי מק"ט):
    • פרטי המקום (מחיר החל מ-0.017 USD לסשן)
    • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
  3. מבצעים אחת מהשיחות או הבקשות הבאות:
    • נייד: קוראים ל-fetchPlace() ב-Android או ל-fetchPlaceFromPlaceID: ב-iOS ומציינים את כל השדות
    • Web API או Web: יש לשלוח בקשה לקבלת פרטי מקום ולציין את כל השדות (בקשה מסוג זה היא ברירת המחדל אם לא מציינים שדות): getPlaceDetails().
    המק"טים האלה יופיעו בחשבון (בהצגת החיוב לפי מק"ט):
    • פרטי המקום (מחיר החל מ-0.017 USD לסשן)
    • נתונים בסיסיים (חיוב בסך 0.00 USD)
    • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
    • נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)

מק"ט: פרטי המקום – רענון מזהה

השתמשו בבקשה Place Details כדי לרענן מזהים של מקומות לא פעילים. בקשות מסוגים כאלה זמינות ללא תשלום.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

יוצרים בקשה לפרטי המקום כדי לציין רק את השדה של מזהה המקום: getPlaceDetails(fields: place_id). בדף החשבון, המק"ט יופיע ברשימה (כשמציגים את החיוב לפי מק"ט):

  • פרטי המקום – רענון מזהה (חיוב בסך 0.00 ש"ח)

מק"ט: Find Place

חיפוש מקום מחויב על בקשה של 'חיפוש מקום'.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.017 USD לכל
(17.00 USD לכל 1000)		 0.0136$ לכל
(13.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

בקשות לחיפוש מקום יוצרות גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אווירה), בהתאם לשדות שצוינו בבקשה. בדומה לבקשות של פרטי מקום, אפשר להשתמש בפרמטר השדות בבקשת 'חיפוש מקום' כדי להגביל את התשובה לשדות שצוינו בלבד. אתם מחויבים על בקשת 'חיפוש מקום' וגם על הנתונים המבוקשים. כברירת מחדל, אם שולחים בקשה לשדות NO, מוחזר רק מזהה המקום, כך שלא יצטברו חיובים נוספים על נתונים.

דוגמאות

  1. שולחים בקשת 'חיפוש מקום' ומציינים רק את שדה הכתובת: FindPlace(fields: formatted_address). בחשבון שלך יופיעו המק"טים האלה (כש מציגים את החיוב לפי מק"ט):
    • חיפוש מקום (מחיר החל מ-0.017 USD לשיחה)
    • נתונים בסיסיים (חיוב בסך 0.00 USD)
  2. עליך לשלוח בקשת 'חיפוש מקום' ולציין את שדה מספר הטלפון: FindPlace(fields: formatted_phone_number). בחשבון שלך יופיעו המק"טים האלה (כש מציגים את החיוב לפי מק"ט):
    • חיפוש מקום (מחיר החל מ-0.017 USD לשיחה)
    • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
  3. יוצרים בקשת 'חיפוש מקום' ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים: FindPlace(fields: formatted_address, opening_hours, price_level). בחשבון שלך יופיעו המק"טים האלה (כש מציגים את החיוב לפי מק"ט):
    • חיפוש מקום (מחיר החל מ-0.017 USD לשיחה)
    • נתונים בסיסיים (חיוב בסך 0.00 USD)
    • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
    • נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)

מק"ט: חיפוש מקום – מזהה בלבד

החיוב חיפוש מקום – מזהה בלבד מחויב על בקשות לחיפוש מקום שמציינות רק את מזהה המקום להחזרה. כברירת מחדל, אם לא צוינו שדות בבקשה 'חיפוש מקום', מוחזר רק מזהה המקום.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

עליך ליצור בקשת 'חיפוש מקום' ולציין רק את השדה place_id: FindPlace(fields: place_id). בדף החשבון, המק"ט יופיע ברשימה (כשמציגים את החיוב לפי מק"ט):

  • חיפוש מקום – תעודה מזהה בלבד (חיוב ב-0.00 USD)

מקום – חיפוש בקרבת מקום מחויב בגין בקשות אל שירות חיפוש בקרבת מקום של Maps JavaScript API (nearbySearch()), או אל שירות 'חיפוש בקרבת מקום' של Places API

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.032 USD לכל
(32.00 USD לכל 1000)		 0.0256$ לכל
(25.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

בקשות של 'חיפוש בקרבת מקום' מחזירות רשימה של מקומות, אבל לא תומכות בציון השדות שיוחזרו. בקשות של 'חיפוש בקרבת מקום' מחזירות קבוצת משנה של שדות הנתונים הנתמכים. החיוב על בקשת 'חיפוש בקרבת מקום' מתחיל מ-0.032$ לכל אחד, וכן על כל המק"טים מסוג נתונים (נתונים בסיסיים, נתונים של אנשי קשר ונתוני אטמוספירה).

דוגמה

שולחים בקשה של 'חיפוש בקרבת מקום', כמו NearbySearch (San Francisco, 100 meters). בחשבון יופיעו המק"טים הבאים (כשמציגים את החיוב לפי מק"ט):

  • מקום - חיפוש בקרבת מקום (מחיר החל מ-0.032 USD לשיחה)
  • נתונים בסיסיים (חיוב בסך 0.00 USD)
  • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
  • נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)

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

המפרסם Place – Text Search מחויב על בקשות שנשלחות אל שירות חיפוש טקסט מקום של Maps JavaScript API (textSearch()), או על שירות חיפוש טקסט של Places API.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.032 USD לכל
(32.00 USD לכל 1000)		 0.0256$ לכל
(25.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

בקשות של 'חיפוש טקסט' מחזירות רשימה של מקומות, אבל לא תומכות לציון השדות שיוחזרו. בקשות של חיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשה של Text Search החל מ-0.032$ לכל אחד, וכן על כל המק"טים מסוג נתונים (נתונים בסיסיים, נתונים של אנשי קשר ונתוני אטמוספירה).

גם המק"ט Place – Text Search נוצר באמצעות הווידג'ט Place SearchBox של Maps JavaScript API: השיטה getPlaces() אחרי שהמשתמש בוחר בשאילתת מקום (סמל: זכוכית מגדלת), ולא תוצאה (סמל: סיכה), כפי שמוצג כאן:

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

דוגמה

שליחת בקשה של חיפוש טקסט, לדוגמה TextSearch(123 Main Street). בחשבון שלכם יופיעו המק"טים הבאים (כשמציגים את החיוב לפי מק"ט):

  • מקום - חיפוש טקסט (מחיר החל מ-0.032 USD לשיחה)
  • נתונים בסיסיים (חיוב בסך 0.00 USD)
  • נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
  • נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)

מק"ט: תמונה של המקום

מק"ט של תמונה של מקום מחויב עבור:

בשירות JavaScript, הפעלה של השיטה PlacePhoto.getUrl() לא גורמת לחיוב עד שכתובת ה-URL תשמש בפועל לקבלת נתוני פיקסלים.

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.007 USD לכל
(7.00 USD לכל 1000)		 0.0056$ לכל
(5.60 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

תמחור לשירותי JavaScript

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

מגבלות שימוש אחרות

אמנם אין מספר מקסימלי של בקשות ביום, אבל מגבלות השימוש הבאות חלות על Maps JavaScript API:

  • 30,000 QPM (בקשות לדקה).
  • 300 QPM (בקשות לדקה) לכל כתובת IP. במסוף Google Cloud, המכסה הזו נקראת טעינת המפה לדקה לכל משתמש.

מגבלות שימוש ב-JavaScript של מפות פוטוריאליסטיות בתלת-ממד במפות Google

מגבלות השימוש הבאות חלות על מפות פוטוריאליסטיות בתלת-ממד במפות Google

  • 100 QPM (בקשות לדקה) .
  • 10 QPM (בקשות לדקה) לכל כתובת IP .

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

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

ניהול עלות השימוש

כדי לנהל את עלות השימוש ב-Maps JavaScript API או כדי לעמוד בביקוש של התנועה בסביבת הייצור, צריך להגדיר מגבלות יומיות על כל הבקשות לכל API. המכסות היומיות מתאפסות בחצות, לפי שעון החוף המערבי של ארה"ב.

כדי לראות או לשנות את מגבלות המכסה של Maps JavaScript API:

  1. במסוף Cloud, פותחים את הדף מכסות בפלטפורמה של מפות Google.
  2. לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים באפשרות Maps JavaScript API.
  3. כדי לראות את המגבלות במכסות, גוללים למטה לכרטיס בקשות.
    מופיעים טבלה עם השמות והמגבלות של המכסות.
  4. כדי לשנות את המכסה, לוחצים על הסמל Edit (עריכה) של המגבלה.
    בתיבת הדו-שיח שמופיעה, בשדה Quota Limit מזינים את המגבלה היומית המועדפת לחיוב (עד למגבלת המכסה, אם יש כזו ש-Google מגדירה) ולוחצים על Save.

אם השימוש ב-API יגיע למגבלת המכסה בכל יום נתון, האפליקציה לא תוכל לגשת ל-API עד סוף היום.

  1. על מנת לקבל את הקרדיט לפלטפורמה של מפות Google, המשתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני שהם יוצרים חשבון לחיוב בפלטפורמה של מפות Google.↩