אופן החיוב של Places API
Places API (חדש) ו-Places API משתמשים במודל תמחור של תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע לפי מק"טים. מתבצע מעקב אחרי השימוש לכל מק"ט, ולכל API או SDK יכול להיות יותר ממק"ט אחד של מוצר. העלות מחושבת לפי:
תוכלו להשתמש במחשבון התמחור והשימוש כדי להעריך את עלות השימוש לכל API או SDK. למק"טים שעומדים בדרישות בפלטפורמה של מפות Google, ניתן לקבל זיכוי בסך 200 דולר ארה"ב בפלטפורמה של מפות Google בכל חודש, לכל חשבון לחיוב. הזיכוי יחול באופן אוטומטי על המק"טים שעומדים בדרישות.
תמחור של Places API (חדש)
מידע על מסיכות שדות
לפרטים לגבי מקום (חדש), חיפוש בקרבת מקום (חדש) ו-Text Search (חדש), משתמשים בכותרת FieldMask
בבקשות API כדי לציין את רשימת השדות שיוחזרו בתשובה. אחר כך תחויבו במק"ט הגבוה ביותר שרלוונטי לבקשה שלכם. המשמעות היא שאם תבחרו שדות גם במק"ט (בסיסי) וגם במק"ט (מתקדם), החיוב יתבצע לפי המק"ט (מתקדם).
כדאי להשתמש באנונימיזציה של שדות כדי לוודא שלא מבקשים נתונים מיותרים, וכך חוסכים זמן עיבוד וחיובים מיותרים.
מידע על סשנים של השלמה אוטומטית (חדשים)
סשן של השלמה אוטומטית (חדש) כולל בקשת השלמה אוטומטית (חדשה) אחת או יותר ובקשת פרטי מקום (חדש) או בקשה לאימות כתובת. אותו אסימון סשן מועבר לבקשת ההשלמה האוטומטית (חדש) ולבקשה הבאה של פרטי מקום (חדש) או לבקשה לאימות כתובת.
סשן מתחיל בבקשה הראשונה של השלמה אוטומטית (חדש). בקשה של פרטי מקום (חדש) או בקשה לאימות כתובת נשלחות כשהמשתמשים בוחרים באחת מהצעות ההשלמה האוטומטית (חדש). אם סשן ננטש, כלומר לא נשלחת בקשה לפרטי מקום (חדש) או בקשה לאימות כתובת, בקשות להשלמה אוטומטית (חדש) יחויבו כאילו לא סופק אסימון סשן.
אחרי שמשתמש בחר מקום (כלומר, נשלחת בקשה לפרטי מקום (חדש) או בקשה לאימות כתובת), אתם צריכים להתחיל סשן חדש באמצעות אסימון סשן חדש.
אסימון סשן טוב לסשן אחד ואי אפשר להשתמש בו ליותר מסשן אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב ללא תקין והחיוב על הבקשות מתבצע כאילו לא סופק אסימון סשן.
מק"ט: בקשות להשלמה אוטומטית
מק"ט של בקשות להשלמה אוטומטית מחויב על כל בקשה ל-API להשלמה אוטומטית (חדש) שלא כוללת אסימון סשן.
הוא מחויב גם אם משתמשים באסימוני סשן וגם אם:
- לסיים את הסשנים באמצעות בקשה אחת לפרטי מקום (חדש) שמבקשת
שדות כלשהם שהוגדרו על ידי מק"ט: פרטי מקום (מיקום בלבד).
- כל בקשה להשלמה אוטומטית (חדשה) מחויבת ב-12 בקשות (לכל היותר) באמצעות SKU: parallel requests.
- כל בקשה נוספת להשלמה אוטומטית (חדשה) מחויבת באמצעות SKU: השלמה אוטומטית בשימוש.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב לכל 1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: שימוש בסשנים של השלמה אוטומטית
מק"ט של השלמה אוטומטית בסשן מחויב על כל בקשה ל-API להשלמה אוטומטית (חדש) שכולל אסימון סשן.
המק"ט מחויב בתרחישים הבאים:
סשן השלמה אוטומטית הסתיים בעקבות קריאה למק"ט: פרטי מקום (מיקום בלבד):
- כל בקשה להשלמה אוטומטית (חדשה) מחויבת ב-12 בקשות (לכל היותר) באמצעות SKU: parallel requests.
- כל בקשה נוספת להשלמה אוטומטית (חדשה) מחויבת באמצעות SKU: השלמה אוטומטית בשימוש.
סשן השלמה אוטומטית הסתיים בקריאה למק"ט: פרטי מקום (בסיסי, מתקדם או מועדף).
קריאה ל'פרטי מקום' שמבקשת כל שדה מהמק"ט: פרטי המקום (בסיסי, מתקדם או מועדף) מחויבת במק"ט: פרטי מקום (מועדף).
סשן השלמה אוטומטית הסתיים בקריאה ל-SKU: Address Validation Preferred.
למידע נוסף ראו השלמה אוטומטית (חדש) ותמחור סשנים.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.00 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.00 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
SKU: פרטי מקום (מזהים בלבד)
באמצעות מסכת שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התשובות רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
attributions
,
id
,
name
*,
photos
* השדה name
מכיל את המקום שם המשאב
בפורמט: places/PLACE_ID
. משתמשים ב-displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
מק"ט: פרטי מקום (מיקום בלבד)
באמצעות מסכת שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התשובות רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.005 דולר ארה"ב לכל (5.00 דולר ארה"ב לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: פרטי המקום (בסיסי)
באמצעות מסכת שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התשובות רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
subDestinations
,
utcOffsetMinutes
אם סשן של השלמה אוטומטית מסתיים על ידי קריאה לפרטי מקום שמבקשת שדה כלשהו מהמק"ט: פרטי מקום (בסיסי, מתקדם או מועדף), החיוב על השיחה מתבצע ב-SKU: Place Details (Preferred) . למידע נוסף, ראו SKU: השלמה אוטומטית של שימוש בסשן.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0170 דולר ארה"ב לכל (17.00 דולר ארה"ב לכל 1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: פרטי מקום (מתקדם)
באמצעות מסכת שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התשובות רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
regularSecondaryOpeningHours
,
userRatingCount
,
websiteUri
אם סשן של השלמה אוטומטית מסתיים על ידי קריאה לפרטי מקום שמבקשת שדה כלשהו מהמק"ט: פרטי מקום (בסיסי, מתקדם או מועדף), החיוב על השיחה מתבצע ב-SKU: Place Details (Preferred) . למידע נוסף, ראו SKU: השלמה אוטומטית של שימוש בסשן.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.020 USD לכל (20.00 USD לכל 1,000) |
0.016 דולר ארה"ב לכל (16.00 דולר ארה"ב לכל 1000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: פרטי מקום (מועדף)
באמצעות מסכת שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התשובות רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
reservable
,
reservable
,
reservable
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
outdoorSeating
,
reservable
,
reservable
,restroom
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
אם סשן של השלמה אוטומטית מסתיים על ידי קריאה לפרטי מקום שמבקשת שדה כלשהו מהמק"ט: פרטי מקום (בסיסי, מתקדם או מועדף), החיוב על השיחה מתבצע ב-SKU: Place Details (Preferred) . למידע נוסף, ראו SKU: השלמה אוטומטית של שימוש בסשן.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.025 דולר ארה"ב לכל (25.00 דולר ארה"ב לכל 1,000) |
0.020 USD לכל (20.00 USD לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: חיפוש בקרבת מקום (בסיסי)
באמצעות מסכת שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום' (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
השדה באינטרנט:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.photos
,
places.plusCode
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.primaryType
,places.primaryTypeDisplayName
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
משתמשים ב-places.displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
0.0256 דולר ארה"ב לכל (25.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: חיפוש בקרבת מקום (מתקדם)
באמצעות מסכת שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום' (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.035 דולר ארה"ב לכל (35.00 דולר ארה"ב לכל 1,000) |
0.028 דולר ארה"ב לכל (28.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: חיפוש בקרבת מקום (מועדף)
באמצעות מסכת שדות או רשימת שדות בבקשת 'חיפוש בקרבת מקום' (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.allowsDogs
,
places.curbsidePickup
,
places.delivery
,
places.dineIn
,
places.editorialSummary
,
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.reservable
,
places.reservable
,
places.reservable
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.reservable
,places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.040 דולר ארה"ב לכל (40.00 דולר ארה"ב לכל 1,000) |
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: Text Search (מזהה בלבד)
באמצעות מסכת שדות או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.attributions
,
places.id
,
places.name
*,
nextPageToken
* השדה places.name
מכיל את המקום שם המשאב
בפורמט: places/PLACE_ID
. משתמשים ב-places.displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000) |
SKU: חיפוש טקסט (בסיסי)
באמצעות מסכת שדות או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.location
,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.subDestinations
,
places.subDestinations
,
{places.types
places.utcOffsetMinutes
places.viewport
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
0.0256 דולר ארה"ב לכל (25.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: חיפוש טקסט (מתקדם)
באמצעות מסכת שדות או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.035 דולר ארה"ב לכל (35.00 דולר ארה"ב לכל 1,000) |
0.028 דולר ארה"ב לכל (28.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: חיפוש טקסט (מועדף)
באמצעות מסכת שדות או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
שירות אינטרנט:
places.allowsDogs
,
places.curbsidePickup
,
places.delivery
,
places.dineIn
,
places.editorialSummary
,
places.evChargeOptions
,
places.fuelOptions
,
places.goodForChildren
,
places.goodForGroups
,
places.goodForWatchingSports
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.reservable
,
places.reservable
,
places.reservable
,
places.liveMusic
,
places.menuForChildren
,
places.parkingOptions
,
places.paymentOptions
,
places.outdoorSeating
,
places.reservable
,
places.reservable
,places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.040 דולר ארה"ב לכל (40.00 דולר ארה"ב לכל 1,000) |
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: תמונת מקום
מק"ט של תמונת מקום מחויב על כל בקשה ל-API.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 דולר ארה"ב לכל (7.00 דולר ארה"ב לכל 1,000) |
0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב לכל 1000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
התמחור של Places API
מידע על סשנים עם השלמה אוטומטית
סשן של השלמה אוטומטית כולל כמה בקשות להשלמה אוטומטית (כדי לאחזר הצעות לגבי מקום בזמן שהמשתמש מקליד), ולכל היותר בקשה אחת לפרטי מקומות (לאחזור פרטים על המקום שנבחר על ידי המשתמש). אותו אסימון סשן מועבר להשלמה האוטומטית ולבקשה הבאה לפרטי מקום. סשן מתחיל בבקשה הראשונה להשלמה אוטומטית (שמתרחשת בדרך כלל כשהמשתמש מתחיל להקליד). הקריאה ל'פרטי מקומות' מתבצעת כשהמשתמש בוחר באחת מההצעות להשלמה אוטומטית. אם המשתמש לא בוחר הצעה, לא תתבצע קריאה לפרטי מקומות.
לאחר שמשתמש בחר מקום (כלומר, מתבצעת קריאה 'פרטי מקומות'), עליכם להתחיל סשן חדש באמצעות אסימון סשן חדש.
ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-API הבאים:
- שירות השלמה אוטומטית של Place API ל-Places API או שירות ההשלמה האוטומטית של Places API ב-Maps JavaScript API. עליכם לתכנן את האפליקציה כך שתספק אסימוני סשן (יכול להיות שתצטרכו לשנות את הקוד הקיים).
- הווידג'ט להשלמה אוטומטית ב-JavaScript API של מפות Google. חיוב לפי סשנים מופעל באופן אוטומטי בווידג'טים האלה, בלי שצריך לשנות את הקוד.
אסימון סשן מתאים לסשן אחד של משתמש ולא ניתן להשתמש בו ליותר מסשן של משתמש אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב ללא תקין והחיוב על הבקשות מתבצע כאילו לא סופק אסימון סשן.
הבקשות להשלמה אוטומטית והבקשות לפרטי מקומות באמצעות סשנים מחויבות במק"טים שונים.
מידע על מק"טים של נתוני מקומות
שלושת המק"טים של נתוני מקומות הם: נתונים בסיסיים, נתוני אנשי קשר ונתוני אטמוספרה.מק"ט אחד או יותר של נתונים מופעל עבור:
- Android: כל בקשה אל
fetchPlace()
אוfindCurrentPlace()
- iOS: כל שיחה אל
fetchPlaceFromPlaceID:
אוfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- שירות אינטרנט: כל בקשה של 'מקומות', בהתאם לשדות שצוינו בבקשה
מק"טים של נתונים תמיד מחויבים בנוסף למק"ט הבסיסי על הבקשה שמפעילה אותם. לדוגמה, בקשה של פרטי מקום, כולל שדות של נתונים בסיסיים, יחויבו גם במק"ט של נתונים בסיסיים וגם במק"ט של פרטי המקום.
עבור שירות האינטרנט, ממשקי ה-API הבאים של מקומות מפעילים תמיכה בציון שדות הנתונים שיוחזרו:
בשירות האינטרנט, ממשקי ה-API האלה של Places API קריאות לא לתמיכה בציון השדות שמוחזרים. הקריאות האלו תמיד מחזירות את כל נתוני המקומות, ומחייבות את שלושת המק"טים של נתוני מקומות בנוסף לחיוב על כל בקשת 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.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.003 USD לכל (+ 3.00 USD לכל 1,000) |
עלות של בקשת מקומות + 0.0024 USD לכל (+ 2.40 USD לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: נתוני אטמוספירה
באמצעות פרמטר השדות בבקשה של 'פרטי המקום' או של 'חיפוש מקום', אפשר להגביל את התשובות רק לשדות שצוינו. שדות בקטגוריה Atmosphere גורמים לחיוב נוסף. המק"ט של נתוני האטמוספרה מופעל כשנשלחת בקשה לאחד מהשדות הבאים:
- 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.005 דולר ארה"ב לכל (+ 5.00 דולר ארה"ב לכל 1,000) |
עלות של בקשת מקומות + 0.004 USD לכל (+ 4.00 USD לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: השלמה אוטומטית – לפי בקשה
המק"ט השלמה אוטומטית – לפי בקשה מחויב על כל אחת מהקריאות או הבקשות שלא כוללות אסימון סשן:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: שירות ההשלמה האוטומטית של מקומות ב-API JavaScript של מפות Google
- שירות אינטרנט: שירות ההשלמה האוטומטית של Places API
גם קריאות שבוצעו מסשן לא חוקי של השלמה אוטומטית (לדוגמה, סשן שנעשה בו שימוש חוזר באסימון סשן) מחויבות גם היא באמצעות 'השלמה אוטומטית' – מק"ט לפי בקשה.
בקשות להשלמה אוטומטית מהווידג'ט של השלמה אוטומטית במקום JavaScript של Maps API עשויות להיות כרוכות בתשלום השלמה אוטומטית – מק"ט לפי בקשה במקרה שקריאות מתבצעות מסשן לא חוקי של השלמה אוטומטית. מצב כזה יכול לקרות כאשר משתמש מקליד מספר כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט, ולא תמיד בוחר חיזוי להשלמה אוטומטית.
טווח נפח חודשי (מחיר לבקשה) |
||
---|---|---|
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב לכל 1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט השלמה אוטומטית ללא פרטי מקום – לכל סשן מחויב על סשן השלמה אוטומטית שלא כולל בקשה של פרטי מקום (תוך כמה דקות מתחילת הסשן).
טווח נפח חודשי (מחיר ל-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?.findcompletePredictions(fromQuery: "par" ...
- placesClient?.findcompletePredictions(fromQuery: "paris" ...
שירות אינטרנט
- שם הבקשה להשלמה אוטומטית במקום (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית במקום (input=”paris”, session_token: XYZ)
בחיוב יופיע המק"ט הזה (בצפייה בחיוב לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל סשן (מחיר החל מ-0.017 דולר ארה"ב לסשן)
SKU: השלמה אוטומטית (כלולה עם פרטי מקום) – לכל סשן
המק"ט של השלמה אוטומטית (כלול בפרטי מקום) – לכל סשן מחויב על סשן השלמה אוטומטית שכולל:
- Android: שיחה אל
fetchPlace()
- iOS: קריאה ל-
fetchPlaceFromPlaceID:
- שירות אינטרנט: בקשה של פרטי מקום
בקשת ההשלמה האוטומטית זמינה ללא תשלום, והשיחה הבאה מסוג 'פרטי המקום' תחייב אתכם לפי המחיר הרגיל של פרטי המקום.
בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספרה), בהתאם לשדות שצוינו בבקשה.
אם לא תציינו שדות בבקשה של פרטי המקום, כל מק"טים של הנתונים יופעלו (בסיסי, יצירת קשר ואטמוספרה).
בקשות לרענון של מזהה פרטי מקום (בקשות שמציינות רק את השדה place_id
) במהלך סשן של השלמה אוטומטית, יחויבו בתור SKU: השלמה אוטומטית
ללא פרטי מקום – לכל סשן.
טווח נפח חודשי (מחיר ל-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?.findcompletePredictions(fromQuery: "par" ...
- placesClient?.findcompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(כולל מזהה המקום והשדה
GMSPlaceFieldFormattedAddress
)
שירות אינטרנט
- בקשה להשלמה אוטומטית של Places (input=”par), session_token: XYZ)
- בקשה להשלמה אוטומטית של Places (input=”paris), session_token: XYZ)
- פרטי מקומות (place_id, session_token: XYZ, שדות:formatted_address)
בחיוב יופיעו המק"טים הבאים (בצפייה בחיוב לפי מק"ט):
- השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן (החיוב מתבצע בסך 0.00 דולר ארה"ב)
- פרטי מקום (מחיר החל מ- 0.017 USD לכל סשן)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
SKU: השלמה אוטומטית של שאילתות – לפי בקשה
מק"ט של השלמה אוטומטית של שאילתות – לפי בקשה מחויב עבור כל בקשה:
- JavaScript:
שירות ההשלמה האוטומטית של Maps JavaScript API (
getQueryPredictions()
) והשימוש ב ווידג'ט SearchBox של API של מפות Google JavaScript (בקשות להשלמה אוטומטית של שאילתות נוצרות כסוגי המשתמשים). - שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות API במקומות שונים
טווח נפח חודשי (מחיר לבקשה) |
||
---|---|---|
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב לכל 1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
אין תמיכה בתמחור באמצעות השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. החיוב על השיחות בקטע 'פרטי המקומות' ייקבע לפי התמחור הרגיל של פרטי המקומות.
מק"ט: פרטי מקום
החיוב על שיחות בפרטי מקום יתבצע באופן הבא:
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 דולר ארה"ב לכל (17.00 דולר ארה"ב לכל 1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
המק"ט Place Details נוצר מממשקי ה-API הבאים:
- Android: Places SDK ל-Android
(
fetchPlace()
) - iOS: Places SDK ל-iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
שירות פרטי המקום של Maps JavaScript API (
getDetails
) - JavaScript:
הווידג'ט 'השלמה אוטומטית' של Maps JavaScript API (
getPlace
) - JavaScript:
הווידג'ט של Place SearchBox של Maps JavaScript:
getPlaces()
לאחר שהמשתמש בוחר תוצאת מקום (סמל: סיכה), *לא* שאילתה (סמל: זכוכית מגדלת), כפי שממחיש כאן:בתוצאות של הווידג'ט של תיבת החיפוש, אחרי הקלדת המילה 'פיצה' בתיבת החיפוש, שימו לב שהסמל פיצה מיקום מופיע לידו. - שירות אינטרנט: שירות פרטי מקום של Places API
באמצעות ה-API והשירותים לאינטרנט, המק"ט של פרטי המקום מחויב גם אם סופק אסימון סשן וגם אם לא.
קריאה או בקשה של פרטי מקום יוצרים גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספרה), בהתאם לשדות שצוינו בשיחה או בבקשה. אם ציינתם את השדות NO בבקשה או בבקשה של פרטי המקום, יופעלו כל המק"טים של הנתונים ותחויבו על השיחה או הבקשה של פרטי המקום בתוספת העלות של כל הנתונים.
דוגמאות
- מבצעים את אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS ומציינים רק את השדהADDRESS
. - Web API או שירות: יוצרים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת:
getPlaceDetails(fields: formatted_address)
- פרטי מקום (מחיר החל מ- 0.017 USD לכל סשן)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נייד: קוראים לפונקציה
- מבצעים את אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS ומציינים רק את השדהPHONE_NUMBER
. - Web API או שירות: שולחים בקשה לפרטי מקום ומציינים את השדה של מספר הטלפון:
getPlaceDetails(fields: formatted_phone_number)
- פרטי מקום (מחיר החל מ- 0.017 USD לכל סשן)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נייד: קוראים לפונקציה
- מבצעים את אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS ומציינים את כל השדות. - Web API או שירות Web: יוצרים בקשה של פרטי מקום ומציינים את כל השדות (בקשה מהסוג הזה מוגדרת כברירת מחדל אם לא מציינים שדות):
getPlaceDetails()
.
- פרטי מקום (מחיר החל מ- 0.017 USD לכל סשן)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נתונים ליצירת קשר (מחיר החל מ-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) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
בבקשות לחיפוש מקום נוצר גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספרה), בהתאם לשדות שצוינו בבקשה. בדומה לבקשות של פרטי מקום, אפשר להשתמש בפרמטר של השדות בבקשת 'חיפוש מקום' כדי להגביל את התגובה רק לשדות שצוינו. אתם מחויבים על הבקשה לחיפוש מקום וגם על הנתונים המבוקשים. כברירת מחדל, אם ממלאים בקשות בשדות NO, מוחזר רק מזהה המקום, כך שלא יחולו חיובים נוספים על נתונים.
דוגמאות
- יוצרים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת:
FindPlace(fields: formatted_address)
. בחשבון החיוב יופיעו המק"טים הבאים (ב הצגת החיוב לפי מק"ט):- חיפוש מקום (מחיר החל מ-0.017 דולר ארה"ב לשיחה)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- יוצרים בקשה לחיפוש מקום ומציינים את השדה של מספר הטלפון:
FindPlace(fields: formatted_phone_number)
. בחיוב יופיעו המק"טים הבאים (ב צפייה בחיוב לפי מק"ט):- חיפוש מקום (מחיר החל מ-0.017 דולר ארה"ב לשיחה)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- יוצרים בקשה של 'חיפוש מקום' ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים:
FindPlace(fields: formatted_address, opening_hours, price_level)
. בחשבון החיוב יופיעו המק"טים הבאים (ב הצגת החיוב לפי מק"ט):- חיפוש מקום (מחיר החל מ-0.017 דולר ארה"ב לשיחה)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אטמוספירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
מק"ט: חיפוש מקום – מזהה בלבד
האפשרות חיפוש מקום – מזהה בלבד מחויבים על בקשות לחיפוש מקום שבהן מצוין רק מזהה המקום שצריך להחזיר. כברירת מחדל, אם לא מצוינים שדות בבקשה 'חיפוש מקום', מוחזר רק מזהה המקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לחיפוש מקום ומציינים רק את השדה place_id
: FindPlace(fields: place_id)
.
בחיוב יופיע המק"ט הזה (בצפייה בחיוב לפי מק"ט):
- חיפוש מקום – תעודה מזהה בלבד (החיוב מתבצע בסכום של 0.00 דולר ארה"ב)
מק"ט: מקום – חיפוש בקרבת מקום
החיוב Place – חיפוש בקרבת מקום מחויב עבור בקשות ל
שירות החיפוש בקרבת מקום של Maps JavaScript API
(nearbySearch()
), או לשירות
Places API Nearby Search
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
0.0256 דולר ארה"ב לכל (25.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
בקשות של 'חיפוש בקרבת מקום' מחזירות רשימה של מקומות, אבל לא תומכות בציון השדות שיוחזרו. בקשות חיפוש בקרבת מקום מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשת חיפוש בקרבת מקום החל מ-0.032 דולר ארה"ב לכל אחד, ועל כל המק"טים של סוגי הנתונים (נתונים בסיסיים, נתונים ליצירת קשר ונתוני אטמוספרה).
דוגמה
אתם שולחים בקשה ל'חיפוש בקרבת מקום', למשל NearbySearch (San Francisco, 100 meters)
.
בחיוב יופיעו המק"טים הבאים (בצפייה בחיוב לפי מק"ט):
- מקום – חיפוש בקרבת מקום (מחיר החל מ- 0.032 USD לשיחה)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אטמוספירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
SKU: מקום – חיפוש טקסט
החיוב Place – חיפוש טקסט מחויב עבור בקשות
לשירות חיפוש הטקסט של Place JavaScript ב-Maps JavaScript API (textSearch()
), או
לשירות חיפוש הטקסט של Places API.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
0.0256 דולר ארה"ב לכל (25.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא ניתן לציין אילו שדות יוחזרו. בקשות מסוג חיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. החיוב על בקשת חיפוש טקסט הוא החל מ-0.032 דולר ארה"ב לכל המק"טים, ועל כל המק"טים מסוג נתונים (נתונים בסיסיים, נתונים ליצירת קשר ונתוני אטמוספרה).
המק"ט 'מקום – חיפוש טקסט' נוצר גם באמצעות
הווידג'ט של תיבת החיפוש של מקום ב-API של מפות Google: getPlaces()
אחרי שהמשתמש בוחר שאילתת מקום (סמל: זכוכית מגדלת), לא תוצאה (סמל: סיכה), כפי שמוצג כאן:
![בחירת שאילתת ווידג'ט של תיבת החיפוש לפרטי מקומות](https://developers.google.cn/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=0000&hl=he)
דוגמה
יוצרים בקשה של חיפוש טקסט, למשל TextSearch(123 Main Street)
. בחיוב יופיעו המק"טים הבאים (בצפייה בחיוב לפי מק"ט):
- מקום – חיפוש טקסט (מחיר החל מ-0.032 דולר ארה"ב לשיחה)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אטמוספירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
מק"ט: תמונת מקום
מק"ט של תמונת מקום מחויב עבור:
- Android: שיחות אל
fetchPhoto()
- iOS: שיחות למספר
loadPlacePhoto:
- JavaScript: אל ספריית המקומות, שירות Place Photos של Maps JavaScript
בעת בקשת נתונים מכתובות ה-URL שהוחזרו על ידי
PlacePhoto.getUrl()
כדי לטעון נתוני פיקסל של תמונות - שירות אינטרנט: בקשות לשירות התמונות של Places API
בשירות JavaScript, הפעלה של השיטה PlacePhoto.getUrl()
לא תגרום לחיוב עד שכתובת ה-URL תשמש בפועל לקבלת נתוני פיקסלים.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 דולר ארה"ב לכל (7.00 דולר ארה"ב לכל 1,000) |
0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב לכל 1000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מגבלות שימוש נוספות
אין מספר מקסימלי של בקשות ליום, אבל עדיין חלות מגבלות השימוש הבאות:
Places API (New): מגבלת הקצב של יצירת הבקשות היא 600 QPM (בקשות לדקה) לכל שיטת API לכל פרויקט. כלומר, לכל method ב-API יש מכסה נפרדת.
Places API: מגבלת הקצב של יצירת הבקשות היא 6,000 QPM (בקשות לדקה). הוא מחושב כסכום הבקשות בצד הלקוח ובצד השרת לכל האפליקציות שמשתמשות בפרטי הכניסה של אותו פרויקט.
הגבלות על התנאים וההגבלות
למידע על התנאים וההגבלות, ראו מדיניות של Places API ומגבלות רישיון בתנאים ובהגבלות של הפלטפורמה של מפות Google.
ניהול עלות השימוש
כדי לנהל את עלות השימוש ב-Places API או כדי לעמוד בדרישות של תעבורת הנתונים בסביבת הייצור, כדאי להגדיר מגבלות מכסה יומיות לכל הבקשות לכל API. המכסות היומיות מתאפסות בחצות, לפי שעון החוף המערבי של ארה"ב.
כדי להציג או לשנות את מגבלות המכסה של Places API:
- במסוף Cloud, פותחים את הדף מכסות בפלטפורמה של מפות Google.
- לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים באפשרות Places API.
- כדי לראות את המגבלות במכסות, גוללים למטה לכרטיס Requests.
בטבלה מפורטות השמות והמגבלות של המכסות. - כדי לשנות מגבלת מכסה, לוחצים על סמל העריכה לצד אותה מכסה.
בתיבת הדו-שיח שמופיעה, בשדה Quota Limit מזינים את המגבלה המועדפת לחיוב של המכסה היומית (עד מגבלת המכסה, אם קיימת) שצוינה על ידי Google, ובוחרים באפשרות Save (שמירה).
אם השימוש ב-API יגיע למגבלת המכסה לחיוב ביום נתון, האפליקציה לא תוכל לגשת ל-API עד סוף היום.