שגיאה: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
Places SDK ל-Android מבוסס על מודל תמחור של תשלום לפי שימוש. Places SDK ל-Android מהבקשות של Places SDK ל-Android מחויבות לפי מק"ט. בנוסף לתנאים ולהגבלות הכוללים של Google, יש מגבלות שימוש ספציפיות ל-Place SDK עבור Android. נהל את העלויות והשימוש שלך באמצעות הכלים הזמינים במסוף Google Cloud.
איך מתבצע החיוב של Places SDK ל-Android
Places SDK ל-Android (חדש) ו-Places SDK ל-Android משתמשים במודל התמחור של תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע לפי מק"טים. השימוש מתבצע לכל מק"ט, ולכל API או SDK יכול להיות יותר ממק"ט מוצר אחד. העלות מחושבת כך:
אפשר להשתמש במחשבון התמחור והשימוש כדי להעריך את עלות השימוש ל-API או ל-SDK. מק"טים שעומדים בדרישות הפלטפורמה של מפות Google יכולים לקבל בכל חודש זיכוי בסך 200 $USD לכל חשבון לחיוב. הזיכוי הזה מוחל באופן אוטומטי על המק"טים שעומדים בדרישות1.
תמחור עבור Places SDK עבור Android (חדש)
מידע על אנונימיזציה של שדות
בבקשות שלכם משתמשים במסכות של שדות, שנקראות גם רשימות שדות, כדי לציין את רשימת השדות שיחזרו בתגובה. לאחר מכן, החיוב מתבצע לפי המק"ט הגבוה ביותר שרלוונטי לבקשה. המשמעות היא שאם בוחרים שדות גם במק"ט (הבסיסי) וגם במק"ט (מתקדם), החיוב מתבצע בהתאם למק"ט (מתקדם).
מומלץ להשתמש במסכת שדה כדי להבטיח שלא תבקשו נתונים מיותרים, וכך להימנע מזמן עיבוד ומחיובים מיותרים.
מק"ט: פרטי המקום (מזהים בלבד)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.PHOTO_METADATAS
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
מק"ט: פרטי המקום (מיקום בלבד)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.ADDRESS
,
Place.Field.LAT_LNG
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.VIEWPORT
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.005$ לכל (5.00 USD לכל 1000) |
0.004 USD לכל (4.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: פרטי המקום (בסיסי)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.BUSINESS_STATUS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.UTC_OFFSET
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0170 USD לכל (17.00 USD לכל 1000) |
0.0136$ לכל (13.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: פרטי המקום (מתקדם)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.020 USD לכל (20.00 USD לכל 1000) |
0.016 USD לכל (16.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: פרטי המקום (מועדף)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.025 USD לכל (25.00 USD לכל 1000) |
0.020 USD לכל (20.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: חיפוש טקסט (מזהה בלבד)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ID
,
Place.Field.NAME
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1000) |
מק"ט: חיפוש טקסט (בסיסי)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD לכל 1000) |
0.0256$ לכל (25.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: Text Search (מתקדם)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.035$ לכל (35.00 USD לכל 1000) |
0.028 USD לכל (28.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: חיפוש טקסט (מועדף)
באמצעות אנונימיזציה של שדות או רשימת שדות בבקשה של פרטי המקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.040 USD לכל (40.00 USD לכל 1000) |
0.032 USD לכל (32.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: תמונה של המקום
המערכת מחייבת את המק"ט של תמונת מקום על כל בקשה ל-API.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 USD לכל (7.00 USD לכל 1000) |
0.0056$ לכל (5.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
תמחור עבור Places SDK עבור Android
מידע על סשנים של השלמה אוטומטית
הפעלה של 'השלמה אוטומטית' כוללת בקשות מסוימות להשלמה אוטומטית (לאחזור הצעות במקום מסוים כשהמשתמשים מקלידים), ולכל היותר בקשה אחת של 'פרטי מקומות' (לאחזור פרטים על המקום שהמשתמש בחר). אותו אסימון סשן מועבר להשלמה האוטומטית ולבקשה הבאה של פרטי המקום. סשן מתחיל בבקשה הראשונה להשלמה אוטומטית (שבדרך כלל מתרחשת כשהמשתמש מתחיל להקליד). מתבצעת קריאה לפרטים של מקומות כאשר המשתמש בחר באחת מההצעות להשלמה אוטומטית. אם משתמש לא בוחר הצעה, לא תתבצע שיחה בפרטי מקומות.
לאחר שמשתמש בחר מקום (כלומר, מתבצעת קריאה לפרטי מקומות), עליך להתחיל פעילות חדשה באתר באמצעות אסימון הפעלה חדש.
ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-API הבאים:
- שירות 'השלמה אוטומטית מקום' ב-Places API או שירות 'השלמה אוטומטית מקומות' של Maps JavaScript API. צריך לתכנן את האפליקציה כך שתספק אסימוני הפעלה (ייתכן שיהיה צורך לשנות את הקוד הקיים).
- הווידג'ט להשלמה אוטומטית של Maps JavaScript API. חיוב המבוסס על פעילות באתר מופעל באופן אוטומטי בווידג'טים האלה, ללא צורך בשינוי הקוד.
אסימון סשן מתאים לסשן של משתמש אחד, ולא כדאי להשתמש בו ליותר מסשן אחד של משתמש. אם עושים שימוש חוזר באסימון סשן, הסשן נחשב לא חוקי והבקשות מחויבות כאילו לא סופק אסימון סשן.
הבקשות להשלמה אוטומטית והבקשות לפרטי מקומות באמצעות סשנים מחויבות במק"טים שונים.
מידע על מק"טים של נתוני מקומות
שלושת המק"טים של נתוני מקומות הם: נתונים בסיסיים, נתונים של אנשי קשר ונתוני אטמוספרה.מק"ט אחד או יותר של נתונים מופעל עבור:
- Android: כל בקשה אל
fetchPlace()
או אלfindCurrentPlace()
- iOS: כל קריאה אל
fetchPlaceFromPlaceID:
או אלfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- שירות אינטרנט: כל בקשת 'מקומות' בהתאם לשדות שצוינו בבקשה
מק"טים של נתונים תמיד מחויבים בנוסף למק"ט הבסיסי על הבקשה שמפעילה אותם. לדוגמה, בקשה של פרטי מקום שכוללת את השדות של 'נתונים בסיסיים' תחויב גם במק"ט של הנתונים הבסיסיים וגם במק"ט של פרטי המקום.
מק"ט: נתונים בסיסיים
באמצעות פרמטר השדות בבקשה 'פרטי מקום' או 'חיפוש מקום' אפשר להגביל את התגובה רק לשדות שצוינו. השדות בקטגוריה 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) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: נתוני אטמוספירה
באמצעות פרמטר השדות בבקשה 'פרטי מקום' או 'חיפוש מקום', אפשר להגביל את התגובה רק לשדות שצוינו. השימוש בשדות בקטגוריה אטמוספירה כרוך בתשלום נוסף. המק"ט של נתוני אטמוספירה מופעל כשנשלחת בקשה לאחד מהשדות הבאים:
- 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$ לכל אחד (+ 4.00 USD ל-1,000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: השלמה אוטומטית – לכל בקשה
המק"ט השלמה אוטומטית – לכל בקשה מחויב על כל הקריאות או הבקשות הבאות שלא כוללות אסימון סשן:
- ב-Android:
findAutocompletePredictions()
- ב-iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: שירות השלמה אוטומטית של מקומות של Maps JavaScript API
- שירות אינטרנט: שירות השלמה אוטומטית של מקומות ב-Places API
שיחות שמקורן בפעילות לא חוקית של השלמה אוטומטית (למשל, סשן שנעשה בו שימוש חוזר באסימון סשן) מחויבות גם היא בהשלמה אוטומטית – לפי מק"ט.
ייתכן שתחויבו על ידי השלמה אוטומטית של בקשות מהווידג'ט להשלמה אוטומטית של מקומות מהווידג'ט להשלמה אוטומטית של מקומות במפות Google. במקרה של הפעלות לא חוקיות של השלמה אוטומטית, ייתכן שתחויבו בהשלמה אוטומטית לפי מק"ט. זה עשוי לקרות כאשר משתמש מקליד מספר כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט ולא תמיד בוחר בחיזוי של השלמה אוטומטית.
טווח נפח חודשי (מחיר לבקשה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1000) |
0.00227 USD לכל (2.27 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט השלמה אוטומטית ללא פרטי מקום – לכל סשן מחויב על סשן השלמה אוטומטית שלא כולל בקשה לפרטי מקום (כמה דקות מתחילת הסשן).
טווח נפח חודשי (מחיר לכל הפעלה) |
||
---|---|---|
0.017 USD לכל (17.00 USD לכל 1000) |
0.0136$ לכל (13.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
דוגמה
אם האפליקציה מעבירה את שתי הקריאות האלה לסשן אחד:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findcompletedictions(fromQuery: "par" ...
- placesClient?.findCompletePredictions(fromQuery: "paris" ...
שירות אינטרנט
- מיקום של בקשה להשלמה אוטומטית (input=”par”, session_token: XYZ)
- מיקום בקשה להשלמה אוטומטית (input=”paris”, session_token: XYZ)
בדף החשבון, המק"ט יופיע ברשימה (כשמציגים את החיוב לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל ביקור (מחיר החל מ-0.017 דולר ארה"ב לסשן)
מק"ט: השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן
הערך של השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן מחויב על סשן של השלמה אוטומטית שכולל כל אחד מהפרטים הבאים:
- Android: שיחה אל
fetchPlace()
- iOS: שיחה אל
fetchPlaceFromPlaceID:
- שירות אינטרנט: בקשה לפרטי מקום
בקשת ההשלמה האוטומטית זמינה ללא תשלום, והשיחה הבאה עם הפרטים לגבי המקום תחויב בהתאם למחיר הרגיל של פרטי מקום.
בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספירה) – בהתאם לשדות שצוינו בבקשה.
אם לא תציינו שדות בבקשת פרטי המקום, כל המק"טים של הנתונים יופעלו (בסיסי, איש קשר ואטמוספירה).
בקשות לרענון של מזהה פרטי מקום (בקשות שמציינות רק את השדה place_id
) במהלך סשן של ההשלמה האוטומטית, מחויבות כ-SKU: השלמה אוטומטית ללא פרטי מקום – לכל סשן.
טווח נפח חודשי (מחיר לכל הפעלה) |
||
---|---|---|
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?.findcompletedictions(fromQuery: "par" ...
- placesClient?.findCompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(כולל את מזהה המקום והשדה
GMSPlaceFieldFormattedAddress
)
שירות אינטרנט
- בקשה להשלמה אוטומטית של מקומות (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית של מקומות (input=”paris”, session_token: XYZ)
- פרטי מקומות (place_id, session_token: XYZ, שדות:formatted_address)
בחשבון יופיעו המק"טים הבאים (כשמציגים את החיוב לפי מק"ט):
- השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן (בחיוב בסך 0.00 ש"ח)
- פרטי המקום (מחיר החל מ-0.017 USD לסשן)
- נתונים בסיסיים (חיוב בסך 0.00 USD)
מק"ט: פרטי המקום
שיחות בפרטי מקום מחויבות באופן הבא:
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 USD לכל (17.00 USD לכל 1000) |
0.0136$ לכל (13.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
המק"ט של פרטי מקום נוצר מממשקי ה-API הבאים:
- Android: Places SDK ל-Android
(
fetchPlace()
) - iOS: Places SDK ל-iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
שירות פרטי המקום של Maps JavaScript API (
getDetails
) - JavaScript:
הווידג'ט להשלמה אוטומטית של מקומות באמצעות Maps JavaScript API (
getPlace
) - JavaScript:
הווידג'ט של Place SearchBox של מפות JavaScript: שיטה
getPlaces()
אחרי שהמשתמש בוחר תוצאת מקום (סמל: סיכה), *לא* שאילתה (סמל: זכוכית מגדלת), כפי שמודגם כאן: - שירות אינטרנט: שירות פרטי מקום של API
באמצעות ה-API והשירותים של האינטרנט, המק"ט של פרטי המקום מחויב גם אם לא סופק אסימון סשן.
קריאה או בקשה של פרטי מקום יוצרים גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספירה), בהתאם לשדות שצוינו בשיחה או בבקשה. אם ציינתם את השדות NO בשיחה או בבקשה של פרטי המקום, יופעלו כל המק"טים של הנתונים, והחיוב יתבצע על השיחה או הבקשה בפרטי המקומות, בתוספת העלות של כל הנתונים.
דוגמאות
- מבצעים אחת מהשיחות או הבקשות הבאות:
- בנייד: אפשר לקרוא ל-
fetchPlace()
ב-Android או ל-fetchPlaceFromPlaceID:
ב-iOS, ולציין רק את השדהADDRESS
- Web API או Web API: שולחים בקשה לפרטי המקום ומציינים רק את שדה הכתובת:
getPlaceDetails(fields: formatted_address)
- פרטי המקום (מחיר החל מ-0.017 USD לסשן)
- נתונים בסיסיים (חיוב בסך 0.00 USD)
- בנייד: אפשר לקרוא ל-
- מבצעים אחת מהשיחות או הבקשות הבאות:
- בנייד: אפשר לקרוא ל-
fetchPlace()
ב-Android או ל-fetchPlaceFromPlaceID:
ב-iOS, ולציין רק את השדהPHONE_NUMBER
- Web API או Web API: יש לשלוח בקשה לפרטי מקום ולציין את שדה מספר הטלפון:
getPlaceDetails(fields: formatted_phone_number)
- פרטי המקום (מחיר החל מ-0.017 USD לסשן)
- נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
- בנייד: אפשר לקרוא ל-
- מבצעים אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים ל-
fetchPlace()
ב-Android או ל-fetchPlaceFromPlaceID:
ב-iOS ומציינים את כל השדות - Web API או Web: יש לשלוח בקשה לקבלת פרטי מקום ולציין את כל השדות (בקשה מסוג זה היא ברירת המחדל אם לא מציינים שדות):
getPlaceDetails()
.
- פרטי המקום (מחיר החל מ-0.017 USD לסשן)
- נתונים בסיסיים (חיוב בסך 0.00 USD)
- נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
- נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)
- נייד: קוראים ל-
מק"ט: חיפוש המקום הנוכחי
החיוב על איתור המקום הנוכחי מחויב על שיחות אל findCurrentPlace()
(Android) או אל findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.030 USD לכל (30.00 USD לכל 1000) |
0.024 USD לכל (24.00 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
קריאות ל-findCurrentPlace()
(ל-Android) ול-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) יוצרות גם מק"טים של נתונים (Basic, Contact ו/או Atmosphere), בהתאם לשדות שצוינו בשיחה.
מציינים שדות נתונים כדי להגביל את התגובה רק לשדות האלה. תחויבו על השיחה של 'איתור המקום הנוכחי' וגם על הנתונים המבוקשים.
דוגמאות
- אפשר לקרוא לפונקציה
findCurrentPlace()
(Android) אוfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(ב-iOS) ולציין רק את השדהADDRESS
. בחשבון שלך יופיעו המק"טים האלה (כשמציגים את החיוב לפי מק"ט):- חיפוש המקום הנוכחי (מחיר החל מ-0.030 USD לבקשה)
- נתונים בסיסיים (חיוב בסך 0.00 USD)
- קוראים לפונקציה
findCurrentPlace()
(Android) אוfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(ב-iOS) ולציין את השדהPHONE_NUMBER
. בחשבון שלך יופיעו המק"טים האלה (כשמציגים את החיוב לפי מק"ט):- חיפוש המקום הנוכחי (מחיר החל מ-0.030 USD לבקשה)
- נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
- קוראים לפונקציה
findCurrentPlace()
(Android) אוfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ולציין שדות מכל שלוש הקטגוריות של סוגי הנתונים. בחשבון שלך יופיעו המק"טים האלה (כשמציגים את החיוב לפי מק"ט):- חיפוש המקום הנוכחי (מחיר החל מ-0.030 USD לבקשה)
- נתונים בסיסיים (חיוב בסך 0.00 USD)
- נתוני יצירת קשר (מחיר החל מ-0.003 USD לבקשה)
- נתוני אטמוספרה (מחיר החל מ-0.005 USD לבקשה)
מק"ט: תמונה של המקום
מק"ט של תמונה של מקום מחויב עבור:
- Android: שיחות אל
fetchPhoto()
- iOS: שיחות אל
loadPlacePhoto:
- JavaScript: אל ספריית מקומות, שירות תמונות מקום של Maps JavaScript API
כאשר מבקשים נתונים מכתובות ה-URL שהוחזרו על ידי
PlacePhoto.getUrl()
כדי לטעון נתונים של פיקסלים של תמונות - שירות אינטרנט: בקשות לשירות תמונות מקום של Places API
בשירות JavaScript, הפעלה של השיטה PlacePhoto.getUrl()
לא גורמת לחיוב עד שכתובת ה-URL תשמש בפועל לקבלת נתוני פיקסלים.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 USD לכל (7.00 USD לכל 1000) |
0.0056$ לכל (5.60 USD לכל 1000) |
כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות |
הגבלות על התנאים וההגבלות
למידע על התנאים וההגבלות, קראו את הקטע הגבלות רישיון בתנאים ובהגבלות של הפלטפורמה של מפות Google.
ניהול עלות השימוש
כדי לנהל את עלויות השימוש ב-Places SDK ל-Android או כדי לעמוד בביקוש של התנועה בסביבת הייצור, צריך להגדיר מגבלות יומיות על כל הבקשות לכל API. המכסות היומיות מתאפסות בחצות, לפי שעון החוף המערבי של ארה"ב.
כדי להציג או לשנות מגבלות מכסה עבור Places SDK ל-Android:
- במסוף Cloud, פותחים את הדף מכסות בפלטפורמה של מפות Google.
- לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים באפשרות Places SDK for Android.
- כדי לראות את המגבלות במכסות, גוללים למטה לכרטיס בקשות.
מופיעים טבלה עם השמות והמגבלות של המכסות. - כדי לשנות את המכסה, לוחצים על הסמל Edit (עריכה) של המגבלה.
בתיבת הדו-שיח שמופיעה, בשדה Quota Limit מזינים את המגבלה היומית המועדפת לחיוב (עד למגבלת המכסה, אם יש כזו ש-Google מגדירה) ולוחצים על Save.
אם השימוש ב-API יגיע למגבלת המכסה בכל יום נתון, האפליקציה לא תוכל לגשת ל-API עד סוף היום.
משאבים קשורים לניהול עלויות
-
על מנת לקבל את הקרדיט לפלטפורמה של מפות Google, המשתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני שהם יוצרים חשבון לחיוב בפלטפורמה של מפות Google.↩