ב-Maps JavaScript API נעשה שימוש במודל תמחור של תשלום לפי שימוש. בקשות של Maps JavaScript API יוצרות קריאות לשני מק"טים שונים, בהתאם לסוג הבקשה: טעינות מפה או תמונות פנורמיות. קריאות ל-Places Library, Maps JavaScript API ולשירותי JavaScript אחרים מתומחרות בנפרד ממק"טים של JavaScript ילידי. בנוסף לתנאי השימוש הכלליים של Google, יש מגבלות שימוש ספציפיות ל-Maps JavaScript API. ניהול העלויות והשימוש באמצעות הכלים שזמינים במסוף Google Cloud.
איך מתבצע החיוב על Maps JavaScript API
ב-Maps JavaScript API נעשה שימוש במודל תמחור של תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע לפי מק"ט. מתבצע מעקב אחר השימוש בכל מק"ט, וכל API או SDK יכולים לכלול יותר ממק"ט מוצר אחד. העלות מחושבת לפי
אתם יכולים להשתמש במחשבון התמחור והשימוש שלנו כדי לחשב את עלות השימוש לכל API או SDK. לכל מק"ט שעומד בדרישות בפלטפורמה של מפות Google, זמין קרדיט של 200 $בפלטפורמה של מפות Google בכל חודש לכל חשבון לחיוב. הזיכוי הזה מוחזר באופן אוטומטי למק"טים שעומדים בדרישות.
תמחור של Maps JavaScript API
מק"ט: Dynamic Maps
אפליקציה שמציגה מפה שנטענת עם או בלי מזהה מפה באמצעות Maps JavaScript API, או מפה שנטענת עם מזהה מפה באמצעות Maps SDK for Android או Maps SDK for iOS.
| טווח נפח חודשי (מחיר לכל טעינת MAP) |
||
|---|---|---|
| 0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
אינטראקציות של משתמשים עם המפה, כמו החלפת שכבות מפה, שינוי מרחק התצוגה או החלפת מיקום המפה, לא יוצרות עומסי טעינה נוספים של המפה.
מק"ט: Street View דינמי
מעכשיו, טעינה של מפות ותמונות פנורמיות של Street View כרוכה בתשלום בנפרד. החיוב על תצוגת Street View דינמית מתבצע על כל יצירה של אובייקט פנורמה באפליקציה של Maps JavaScript API, Maps SDK for Android או Maps SDK for iOS.
| טווח נפח חודשי (מחיר לכל PANORAMA) |
||
|---|---|---|
| 0.014$ לכל (14.00$ ל-1,000) |
0.0112 USD לכל (11.20 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
יצירת אובייקט פנורמה מתרחשת:
- ב-JavaScript, באמצעות השיטה
Map.getStreetView()או הכיתהgoogle.maps.StreetViewPanorama(). לא תחויבו על חוויית Street View המובנית שמבוססת על הכלי לניווט ב-Street View, ולא על השימוש בכיתהStreetViewService(). - ב-Android, באמצעות אחת מהקלאסות
StreetViewPanoramaFragment,SupportStreetViewPanoramaFragmentאוStreetViewPanoramaView. תמונה פנורמית נספרת בכל פעם שמפעילים את השיטה הקשורהonCreate(). - ב-iOS, באמצעות האובייקט
GMSPanoramaView.
התמחור של ספריית המקומות, Maps JavaScript API
מק"ט: בקשות להשלמה אוטומטית
Autocomplete Requests (בקשות להשלמה אוטומטית) – מק"ט לחיוב על כל בקשה ל-Autocomplete API (חדש) שלא כוללת אסימון סשן.
החיוב מתבצע גם אם אתם משתמשים באסימוני סשן וגם:
- כדי לסיים את הסשנים, שולחים בקשה אחת ל-Place Details (New) שבה מבקשים את כל השדות שמוגדרים על ידי SKU: Place Details (Location Only).
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
- כדי לסיים את הסשן או לבטל אותו, צריך לבצע קריאה ל-SKU: Place Details (IDs Only). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות המק"ט Autocomplete Requests.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.00283$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: שימוש בסשן של השלמה אוטומטית
מק"ט של שימוש בסשן של השלמה אוטומטית מחויב על כל בקשה ל-API של השלמה אוטומטית (חדש) שכוללת אסימון סשן.
המק"ט הזה מחויב בתרחישים הבאים:
סשן ההשלמה האוטומטית הסתיים על ידי קריאה ל-SKU: פרטי מקום (מיקום בלבד):
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Place Details (Basic, Advanced, or Preferred).
קריאה ל-Place Details שמבקשת כל שדה מ-SKU: Place Details (Basic, Advanced או Preferred) מחויבת לפי SKU: Place Details (Preferred).
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Address Validation Preferred.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.00 USD לכל (0.00 USD ל-1,000) |
0.00 USD לכל (0.00 USD ל-1,000) |
0.00 USD לכל (0.00 USD ל-1,000) |
מק"ט: פרטי מקום (מזהים בלבד)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התשובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
id,
photos
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.0 USD לכל (0.00 USD לכל 1,000) |
0.0 USD לכל (0.00 USD לכל 1,000) |
0.0 USD לכל (0.00 USD לכל 1,000) |
מק"ט: פרטי מקום (מיקום בלבד)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התשובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
addressComponents,
adrFormatAddress,
formattedAddress,
location,
plusCode,
types,
viewport
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי מקום (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התשובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
accessibilityOptions,
businessStatus,
displayName,
googleMapsUri,
iconBackgroundColor,
primaryTypeDisplayName,
svgIconMaskURI,
types,
utcOffsetMinutes
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.0170 דולר ארה"ב לכל (17.00 דולר ארה"ב ל-1,000) |
0.0136$ לכל (13.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי מקום (מתקדם)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התשובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
internationalPhoneNumber,
nationalPhoneNumber,
priceLevel,
rating,
regularOpeningHours,
userRatingCount,
websiteUri
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.020 USD לכל (20.00 USD ל-1,000) |
0.016 USD לכל (16.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי מקום (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התשובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
allowsDogs,
editorialSummary,
evChargeOptions,
fuelOptions,
hasCurbsidePickup,
hasDelivery,
hasDineIn,
hasLiveMusic,
hasMenuForChildren,
hasOutdoorSeating,
hasRestroom,
hasTakeout,
hasWifi,
isGoodForChildren,
isGoodForGroups,
isGoodForWatchingSports,
isReservable,
parkingOptions,
paymentOptions,
priceLevel,
reviews,
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.025 USD לכל (25.00 USD ל-1,000) |
0.020 USD לכל (20.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
accessibilityOptions,
addressComponents,
adrFormatAddress,
businessStatus,
displayName,
formattedAddress,
googleMapsUri,
iconBackgroundColor,
id,
location,
photos,
plusCode,
svgIconMaskURI,
types,
utcOffsetMinutes,
viewport
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (מתקדם)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
internationalPhoneNumber,
nationalPhoneNumber,
priceLevel,
rating,
regularOpeningHours,
userRatingCount,
websiteUri
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.035$ לכל (35.00$ ל-1,000) |
0.028$ לכל (28.00$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
allowsDogs,
editorialSummary,
evChargeOptions,
fuelOptions,
hasCurbsidePickup,
hasDelivery,
hasDineIn,
hasLiveMusic,
hasMenuForChildren,
hasOutdoorSeating,
hasRestroom,
hasTakeout,
hasWifi,
isGoodForChildren,
isGoodForGroups,
isGoodForWatchingSports,
isReservable,
parkingOptions,
paymentOptions,
priceLevel,
reviews,
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.040 USD לכל (40.00 USD ל-1,000) |
0.032 USD לכל (32.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מזהה בלבד)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
id
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.0 USD לכל (0.00 USD לכל 1,000) |
0.0 USD לכל (0.00 USD לכל 1,000) |
0.0 USD לכל (0.00 USD לכל 1,000) |
מק"ט: חיפוש טקסט (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
accessibilityOptions,
addressComponents,
adrFormatAddress,
businessStatus,
displayName,
formattedAddress,
googleMapsUri,
iconBackgroundColor,
location,
photos,
plusCode,
svgIconMaskURI,
types,
utcOffsetMinutes,
viewport
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מתקדם)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
internationalPhoneNumber,
nationalPhoneNumber,
priceLevel,
rating,
regularOpeningHours,
userRatingCount,
websiteUri
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.035$ לכל (35.00$ ל-1,000) |
0.028$ לכל (28.00$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
ספריית מקומות, Maps JavaScript API:
allowsDogs,
editorialSummary,
evChargeOptions,
fuelOptions,
hasCurbsidePickup,
hasDelivery,
hasDineIn,
hasLiveMusic,
hasMenuForChildren,
hasOutdoorSeating,
hasRestroom,
hasTakeout,
hasWifi,
isGoodForChildren,
isGoodForGroups,
isGoodForWatchingSports,
isReservable,
parkingOptions,
paymentOptions,
priceLevel,
reviews,
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.040 USD לכל (40.00 USD ל-1,000) |
0.032 USD לכל (32.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Place Photo
על כל בקשה ל-API תחויבו במק"ט Place Photo.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מידע על סשנים של השלמה אוטומטית
סשן של השלמה אוטומטית כולל כמה בקשות להשלמה אוטומטית (כדי לאחזר הצעות למיקום בזמן שהמשתמש מקלידים) ובקשת פרטים על מקומות אחת לכל היותר (כדי לאחזר פרטים על המיקום שבחר המשתמש). אותו אסימון סשן מועבר להשלמה האוטומטית ולבקשה הבאה לקבלת פרטי המקום. סשן מתחיל בבקשה הראשונה להשלמה אוטומטית (שמתרחשת בדרך כלל כשהמשתמש מתחיל להקליד). קריאה ל-Places Details מתבצעת כשהמשתמש בוחר באחת מההצעות של המילוי האוטומטי. אם המשתמש לא יבחר הצעה, לא תתבצע קריאה ל-Places Details.
אחרי שמשתמש בוחר מקום (כלומר, אחרי שמתבצעת קריאה ל-Places Details), צריך להתחיל סשן חדש באמצעות אסימון סשן חדש.
אפשר ליצור סשנים של השלמה אוטומטית מהממשקי ה-API הבאים:
- שירות ההשלמה האוטומטית של מקומות ב-Places API או שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API. צריך לתכנן את האפליקציה כך שתספק אסימוני סשן (יכול להיות שתצטרכו לשנות את הקוד הקיים).
- הווידג'ט של השלמה אוטומטית של Maps JavaScript API. החיוב על סמך סשנים מופעל באופן אוטומטי בווידג'טים האלה, בלי צורך בשינוי בקוד.
אסימון סשן תקף לסשן משתמש אחד, ואסור להשתמש בו ביותר מסשן משתמש אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב לא חוקי והבקשות מחוייבות כאילו לא סופק אסימון סשן.
הבקשות להשלמה אוטומטית והבקשות לפרטים על מקומות באמצעות סשנים מחויבות לפי מק"טים שונים.
מידע על מק"טים של נתוני מקומות
שלושת המק"טים של נתוני המקומות הם: נתונים בסיסיים, פרטים ליצירת קשר ונתוני אווירה.מק"ט אחד או יותר של נתונים מופעל עבור:
- Android: כל בקשה ל-
fetchPlace()או ל-findCurrentPlace() - iOS: כל קריאה ל-
fetchPlaceFromPlaceID:או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - שירות אינטרנט: כל בקשה ל-Places בהתאם לשדות שצוינו בבקשה
תמיד תחויבו על מק"טים של נתונים בנוסף למק"ט הבסיס של הבקשה שהפעילה אותם. לדוגמה, בקשה לפרטים על מקום שכוללת שדות של נתונים בסיסיים תחויב גם לפי המק"ט של נתונים בסיסיים וגם לפי המק"ט של פרטים על מקום.
בשירות האינטרנט, הקריאות האלה לממשקי API של Places תומכות בהגדרת שדות הנתונים שיוחזר:
בשירות האינטרנט, הקריאות ל-Places APIs האלה לא תומכות בציינה של השדות שיוחזרו. הקריאות האלה תמיד מחזירות את כל נתוני Places, והחיוב הוא על שלושת המק"טים של נתוני Places בנוסף לחיוב על כל בקשת API:
מק"ט: נתונים בסיסיים
באמצעות הפרמטר fields בבקשה לפרטים של מקום או בבקשה לחיפוש מקום, אפשר להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה בסיסי כלולים בעלות הבסיסית של הבקשה ל-Places ולא גוררים חיוב נוסף. המק"ט Basic Data מופעל כשמתבצעת בקשה לאחד מהשדות הבאים:
-
Android:
Place.Field.ACCESSIBILITY_OPTIONS,Place.Field.ADDRESS_COMPONENTS,Place.Field.BUSINESS_STATUS,Place.Field.DISPLAY_NAME,Place.Field.FORMATTED_ADDRESS,Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_MASK_URL,Place.Field.ID,Place.Field.LOCATION,Place.Field.PHOTO_METADATAS,Place.Field.PLUS_CODE,Place.Field.TYPES,Place.Field.VIEWPORTאוPlace.Field.UTC_OFFSET. -
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
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
מק"ט: פרטי איש קשר
אפשר להגביל את התגובה רק לשדות שצוינו באמצעות הפרמטר fields בבקשה לפרטים של מקום או ל'חיפוש מקום' בשירותי אינטרנט, או באמצעות מערך של Place.Field ב-Android או ב-iOS. שדות בקטגוריה איש קשר יגרמו לחיוב נוסף. המק"ט פרטים ליצירת קשר מופעל כשמבקשים את אחד מהשדות הבאים:
-
Android:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.INTERNATIONAL_PHONE_NUMBER,Place.Field.OPENING_HOURS,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
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| עלות הבקשה ל-Places + 0.003$ לכל בקשה (+ 3.00$ לכל 1,000 בקשות) |
עלות הבקשה ל-Places + 0.0024 דולר ארה"ב לכל בקשה (+ 2.40 דולר ארה"ב ל-1,000 בקשות) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: נתוני אטמוספרה
באמצעות הפרמטר fields בבקשה לקבלת פרטי מקום או בבקשה לחיפוש מקום, אפשר להגביל את התשובה רק לשדות שצוינו. שדות בקטגוריה Atmosphere יגרמו לחיוב נוסף. המק"ט Atmosphere Data מופעל כשמבקשים את אחד מהשדות הבאים:
- 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_RATING_COUNT
- 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.005$ לכל בקשה (+ 5.00$ לכל 1,000 בקשות) |
עלות הבקשה ל-Places + 0.004$ לכל בקשה (+ 4.00$ לכל 1,000 בקשות) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: השלמה אוטומטית – לכל בקשה
העלויות של המק"ט Autocomplete – Per Request חלות על כל הקריאות או הבקשות האלה שלא כוללות אסימון סשן:
- Android:
findAutocompletePredictions() - iOS:
findAutocompletePredictionsFromQuery: - JavaScript: השירות של מילוי אוטומטי של מקומות ב-Maps JavaScript API
- שירות אינטרנט: שירות ההשלמה האוטומטית של מקומות ב-Places API
גם על שיחות שמבוצעות מסשן לא חוקי של השלמה אוטומטית (לדוגמה, סשן שבו נעשה שימוש חוזר בטוקן של סשן) מחויב המק"ט 'השלמה אוטומטית – לכל בקשה'.
אם יתבצעו קריאות מסשן השלמה אוטומטית לא תקין, יכול להיות שתחויבו על בקשות השלמה אוטומטית מ-ווידג'ט השלמה אוטומטית של מיקום מ-Maps JavaScript API לפי מק"ט 'השלמה אוטומטית – לכל בקשה'. מצב כזה יכול לקרות כשמשתמש מקלידים כמה כתובות שונות או מעתיקים/מדביקים כתובות שונות לווידג'ט, ולא תמיד בוחרים תחזית להשלמה אוטומטית.
| טווח נפח חודשי (מחיר לכל בקשה) |
||
|---|---|---|
| 0.00283$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט Autocomplete without Place Details – Per Session מחויב על סשן של השלמה אוטומטית שלא כולל בקשה לפרטים על מקום (בתוך כמה דקות מתחילת הסשן).
| טווח נפח חודשי (מחיר לכל סשן) |
||
|---|---|---|
| 0.017$ לכל (17.00$ ל-1,000) |
0.0136$ לכל (13.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
דוגמה
אם האפליקציה שלכם מבצעת את שתי הקריאות האלה בסשן אחד:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
שירות אינטרנט
- בקשה להשלמה אוטומטית של מקום (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית של מקום (input=”paris”, session_token: XYZ)
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל סשן (המחיר מתחיל ב-0.017$ לכל סשן)
מק"ט: השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן
החיוב על המק"ט השלמה אוטומטית (כלולה בפרטים על מקומות) – לכל סשן מתבצע על סשן השלמה אוטומטית שכולל אחד מהאירועים הבאים:
- Android: קריאה ל-
fetchPlace() - iOS: קריאה ל-
fetchPlaceFromPlaceID: - שירות אינטרנט: בקשה לקבלת פרטי מקום
הבקשה להשלמה האוטומטית זמינה ללא תשלום, והקריאה הבאה לקבלת פרטי המקום מחויבת לפי המחירון הרגיל של פרטי המקום.
בקשה לפרטים על מקום יוצרת מק"טים של נתונים (Basic, Contact ו/או Atmosphere) בהתאם לשדות שצוינו בבקשה.
אם לא מציינים שדות בבקשה לפרטים על המקום, כל המק"טים של נתונים מופעלים (Basic, Contact ו-Atmosphere).
בקשות לרענון מזהה של פרטי מקום (בקשות שמציינות רק את השדה place_id) במהלך סשן של השלמה אוטומטית מחוייבות כ-SKU: Autocomplete without Place Details – Per Session.
| טווח נפח חודשי (מחיר לכל סשן) |
||
|---|---|---|
| 0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
אם האפליקציה שלכם מבצעת את שלוש הקריאות הבאות בסשן אחד:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (עם
FetchPlaceRequestשכולל את מזהה המקום ואת השדה ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(כולל מזהה המקום והשדה
GMSPlaceFieldFormattedAddress)
שירות אינטרנט
- בקשה להשלמה אוטומטית של מקומות (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית של מקומות (input=”paris”, session_token: XYZ)
- פרטי מקומות (place_id, session_token: XYZ, fields:formatted_address)
המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן (החיוב הוא 0.00$)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה
המחיר של המק"ט השלמה אוטומטית של שאילתות – לכל בקשה מחויב על כל בקשה ל:
- JavaScript:
שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API (
getQueryPredictions()) והשימוש ב ווידג'ט SearchBox של Maps JavaScript API (בקשות להשלמה אוטומטית של שאילתות נוצרות בזמן שהמשתמש מקלידים). - שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות ב-Places API
| טווח נפח חודשי (מחיר לכל בקשה) |
||
|---|---|---|
| 0.00283$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
אין תמיכה בתמחור לפי סשן של השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. על קריאות חוזרות ל-Places Details תחויבו לפי התמחור הרגיל של Places Details.
מק"ט: פרטי מקומות
החיוב על שיחות לקבלת פרטי מקומות מתבצע באופן הבא:
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.017$ לכל (17.00$ ל-1,000) |
0.0136$ לכל (13.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
המק"ט Places Details נוצר מהממשקי ה-API הבאים:
- Android: Places SDK ל-Android
(
fetchPlace()) - iOS: Places SDK ל-iOS
(
fetchPlaceFromPlaceID:) - JavaScript:
שירות פרטי המקומות של Maps JavaScript API (
getDetails) - JavaScript:
ווידג'ט של מילוי אוטומטי של מקומות ב-Maps JavaScript API (
getPlace) - JavaScript:
ווידג'ט של תיבת חיפוש מקומות ב-Maps JavaScript API: ה-method
getPlaces()אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדיל), כפי שמוצג כאן:
בתוצאות של הווידג'ט של תיבת החיפוש, אחרי שמקלידים 'פיצה' בתיבת החיפוש, רואים שלצד Pizza Autentico מופיע סמל סיכה, שמציין שמדובר בתוצאת חיפוש של מקום (ולא בשאילתה). - שירות אינטרנט: שירות פרטי המקומות של Places API
כשמשתמשים ב-API האינטרנטי ובשירותים, מתבצע חיוב על המק"ט של פרטי המקום גם אם סיפקת אסימון סשן וגם אם לא.
קריאה או בקשה לפרטים של מקום יוצרות גם מק"טים של נתונים (Basic, Contact ו/או Atmosphere), בהתאם לשדות שצוינו בקריאה או בבקשה. אם לא מציינים אף שדה בקריאה או בבקשה לקבלת פרטי המקום, מופעלים כל המק"טים של הנתונים, ותחויבו על הקריאה או הבקשה לקבלת פרטי המקום ועל עלות כל הנתונים.
דוגמאות
- מבצעים אחת מהפעולות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()ב-Android או לפונקציהfetchPlaceFromPlaceID:ב-iOS, ומציינים רק את השדהADDRESS - Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת:
getPlaceDetails(fields: formatted_address)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
- נייד: קוראים לפונקציה
- מבצעים אחת מהפעולות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()ב-Android או לפונקציהfetchPlaceFromPlaceID:ב-iOS, ומציינים רק את השדהPHONE_NUMBER - שירות או ממשק API לאינטרנט: שולחים בקשה לפרטים של מקום ומציינים את השדה של מספר הטלפון:
getPlaceDetails(fields: formatted_phone_number)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נייד: קוראים לפונקציה
- מבצעים אחת מהפעולות הבאות:
- נייד: מחייגים למספר
fetchPlace()ב-Android או למספרfetchPlaceFromPlaceID:ב-iOS ומציינים את כל השדות - Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות):
getPlaceDetails().
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
- נייד: מחייגים למספר
מק"ט: פרטי מקומות – רענון מזהה
אפשר להשתמש בבקשה 'פרטי מקום' כדי לרענן מזהים של מקומות לא עדכניים. הבקשות האלה זמינות ללא תשלום.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לקבלת פרטי מקום ומציינים רק את השדה 'מזהה מקום':
getPlaceDetails(fields: place_id).
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- פרטי מקומות – רענון מזהה (החיוב הוא 0.00$)
מק"ט: חיפוש מקום
חיפוש מקום מחויב על בקשה לחיפוש מקום.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.017$ לכל (17.00$ ל-1,000) |
0.0136$ לכל (13.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות ל'חיפוש מקום' יוצרות גם מק"טים של נתונים (בסיסי, איש קשר ו/או אווירה), בהתאם לשדות שצוינו בבקשה. בדומה לבקשות לפרטים של מקומות, אפשר להשתמש בפרמטר fields בבקשה לחיפוש מקום כדי להגביל את התגובה רק לשדות שצוינו. אתם מחויבים על הבקשה לחיפוש מקום ועל הנתונים שביקשת. כברירת מחדל, אם לא מבקשים אף שדה, המערכת מחזירה רק את מזהה המקום, כך שלא נצברות חיובים נוספים על נתונים.
דוגמאות
- שולחים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת:
FindPlace(fields: formatted_address). המק"טים האלה יופיעו בחשבון (כש מציגים את החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- שולחים בקשה לחיפוש מקום ומציינים את השדה של מספר הטלפון:
FindPlace(fields: formatted_phone_number). המק"טים האלה יופיעו בחשבונית (כש מציגים את החשבונית לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- שולחים בקשה לחיפוש מקום ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים:
FindPlace(fields: formatted_address, opening_hours, price_level). המק"טים האלה יופיעו בחשבונית (כש מציגים את החשבונית לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: חיפוש מקום – מזהה בלבד
החיוב על חיפוש מקום – מזהה בלבד חל על בקשות לחיפוש מקום שמציינות רק את מזהה המקום שצריך להחזיר. כברירת מחדל, אם לא מציינים שדות בבקשה Find Place, רק מזהה המקום מוחזר.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לחיפוש מקום ומציינים רק את השדה place_id: FindPlace(fields: place_id).
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- חיפוש מקום – מזהה בלבד (החיוב הוא 0.00$)
מק"ט: מקומות – חיפוש בקרבת מקום
ב-Places – חיפוש בקרבת מקום, החיוב הוא על בקשות ל
שירות חיפוש מקומות בקרבת מקום של Maps JavaScript API (nearbySearch()) או ל
שירות חיפוש בקרבת מקום של Places API.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש בקרבת מקום מחזירות רשימה של מקומות, אבל לא תומכות בציינה של השדות שיוחזרו. בקשות לחיפוש בקרבת מקום מחזירות קבוצת משנה של שדות הנתונים הנתמכים. החיוב על בקשה לחיפוש בקרבת מקום מתחיל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (נתונים בסיסיים, פרטים ליצירת קשר ונתוני אטמוספרה).
דוגמה
שולחים בקשה לחיפוש בקרבת מקום, כמו NearbySearch (San Francisco, 100 meters).
המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- מקום – חיפוש בקרבת מקום (המחיר מתחיל ב-0.032$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: מקומות – חיפוש טקסט
ב-Places – חיפוש טקסט תחויבו על בקשות ל
שירות חיפוש טקסט של מקומות ב-Maps JavaScript API (textSearch()) או ל
שירות חיפוש טקסט של Places API.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא תומכות בתיאור של השדות שיוחזרו. בקשות לחיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשת חיפוש טקסט החל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (Basic Data, Contact Data ו-Atmosphere Data).
המק"ט 'מיקום – חיפוש טקסט' נוצר גם על ידי השיטה getPlaces() של
הווידג'ט Place SearchBox של ממשק API של JavaScript במפות Google, אחרי שהמשתמש בוחר שאילתה למיקום (סמל: זכוכית מגדלת), לא תוצאה (סמל: סיכה), כפי שמוצג כאן:
דוגמה
שולחים בקשה לחיפוש טקסט, למשל TextSearch(123 Main Street). המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- מקום – חיפוש טקסט (המחיר מתחיל ב-0.032$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: תמונה של מקומות
מק"ט של תמונה ב-Places מחויב על:
- Android: קריאות אל
fetchPhoto() - iOS: קריאות אל
loadPlacePhoto: - JavaScript: לספריית המקומות, שירות התמונות של המקומות של Maps JavaScript API כשמבקשים נתונים מכתובות ה-URL שמוחזרות על ידי
PlacePhoto.getUrl()כדי לטעון נתוני פיקסלים של תמונות - שירות אינטרנט: בקשות לשירות התמונות של Places API
בשירות JavaScript, הקריאה ל-method PlacePhoto.getUrl() לא גורמת לחיוב עד שמשתמשים בכתובת ה-URL בפועל כדי לקבל נתוני פיקסלים.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
תמחור שירותי JavaScript
המחירים של שירותי JavaScript נקבעים בנפרד. מידע נוסף זמין בדף השימוש והחיוב של השירות:
- שירות מסלולים – שימוש ב-Directions API וחיוב
- שירות מטריצת מרחקים – שימוש בחיוב ב-Distance Matrix API
- Elevation Service – שימוש בחיוב ב-Elevation API
- שירותי גיאוקוד – שימוש בחיוב ב-Geocoding API
- שירות Street View – שימוש בחיוב ב-Street View API
מגבלות שימוש אחרות
אין מספר מקסימלי של בקשות ליום, אבל יש מגבלות שימוש על השימוש ב-Maps JavaScript API:
- 30,000 בקשות לדקה.
- 300 בקשות לשעה (QPH) לכל כתובת IP. במסוף Google Cloud, המכסה הזו נקראת טעינות מפה לדקה לכל משתמש.
מגבלות השימוש ב-JavaScript במפות תלת-ממד ריאליסטיות במפות Google
מגבלות השימוש הבאות חלות על מפות 3D ריאליסטיות ב-JavaScript של מפות Google
- 100 בקשות לדקה.
- 10 בקשות לדקה (QPM) לכל כתובת IP .
הגבלות בנוגע לתנאים ולהגבלות
פרטים מלאים על השימוש המותר מפורטים בקטע 'הגבלות רישיון' בתנאים ובהגבלות של פלטפורמת מפות Google.
ניהול עלות השימוש
כדי לנהל את עלות השימוש ב-Maps JavaScript API או כדי לעמוד בדרישות של תעבורת הנתונים בסביבת הייצור, אפשר להגדיר מכסות יומיות לכל הבקשות לכל ממשק API. המכסות היומיות מתאפסים בחצות לפי שעון החוף המערבי.
כדי להציג או לשנות את מגבלות המכסה של Maps JavaScript API:
- במסוף Cloud, פותחים את הדף Google Maps Platform Quotas.
- לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים באפשרות Maps JavaScript API.
- כדי לראות את מגבלות המכסות, גוללים למטה לכרטיס Requests.
טבלה עם שמות המכסות והמגבלות שלהן. - כדי לשנות את מגבלת המכסה, לוחצים על סמל עריכה של המגבלה הרלוונטית.
בתיבת הדו-שיח שמופיעה, בשדה Quota Limit, מזינים את המכסה היומית המועדפת לחיוב (עד למכסה שצוינה על ידי Google, אם יש כזו) ובוחרים באפשרות Save.
אם השימוש ב-API יגיע למגבלת המכסה לחיוב ביום נתון, לא תהיה לאפליקציה גישה ל-API עד סוף היום.