SDK של מקומות לשימוש ולחיוב ב-Android

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

שגיאה: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

ערכת ה-SDK של מקומות ל-Android משתמשת במודל תמחור מסוג 'תשלום לפי שימוש'. החיוב על בקשות SDK של מקומות ב-Android עבור מקומות SDK ל-Android מתבצע באמצעות מק"ט. בנוסף לתנאים ולהגבלות הכוללים של Google, קיימות מגבלות שימוש ספציפיות ל-SDK של מקומות ל-Android. ניהול העלויות והשימוש באמצעות הכלים הזמינים במסוף Google Cloud.

אופן החיוב של SDK של מקומות ל-Android

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

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

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

תמחור SDK של מקומות ל-Android

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

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

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

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

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

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

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

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

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

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

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

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

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

  • במכשירי 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
  • iOS : GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, 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, ניתן להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה איש קשר מחייבים בתשלום נוסף. המק"ט של נתוני איש הקשר מופעל בכל פעם שמתקיים שדה חובה:

  • Android: Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER או 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 לכל 1000)		 עלות בקשת המקומות
+ 0.0024 USD לכל אחד
(+ 2.40 USD לכל 1000)		 ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

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

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, 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 USD לכל אחד
(+ 5.00 USD לכל 1000)		 עלות בקשת המקומות
+ 0.004 USD לכל אחד
(+ 4.00 USD לכל 1000)		 ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

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

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

בקשות להשלמה אוטומטית מווידג'ט ההשלמה האוטומטית ל-API של מפות 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 דולר ארה"ב לכל
(17.00 דולר ארה"ב ל-1000)		 0.0136 דולר ארה"ב לכל
(13.60 דולר ארה"ב ל-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 דולר ארה"ב לביקור)
  • נתונים בסיסיים (חיוב של 0.00 USD)

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

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

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

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

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

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

דוגמאות

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

מק"ט: איתור המקום הנוכחי

הכרטיס חיפוש מקום נוכחי מחויב על שיחות אל findCurrentPlace() (Android) או findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.030 דולר ארה"ב לכל
(30.00 דולר ארה"ב ל-1000)		 0.024 דולר ארה"ב לכל
(24.00 דולר ארה"ב ל-1000)		 ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

שיחות ל-findCurrentPlace() (Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) מניבות גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אווירה), בהתאם לשדות שצוינו בשיחה. אפשר לציין שדות נתונים כדי להגביל את התגובה לשדות האלה בלבד. נחייב אתכם על השיחה ב'חיפוש מיקום נוכחי' ועל הנתונים הנדרשים.

דוגמאות

  1. אפשר להתקשר אל findCurrentPlace() (Android) או אל findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (ל-iOS) ולציין רק את השדה ADDRESS. בחשבון יופיעו המק"טים הבאים (בעת הצגת החיוב לפי מק"ט):
    • איתור המקום הנוכחי (המחיר החל מ- 0.030 USD לבקשה)
    • נתונים בסיסיים (חיוב של 0.00 USD)
  2. אפשר להתקשר אל findCurrentPlace() (Android) או אל findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (ל-iOS) ולציין את השדה PHONE_NUMBER. בחשבון יופיעו המק"טים הבאים (כשמציגים את החיוב לפי מק"ט):
    • איתור המקום הנוכחי (המחיר החל מ- 0.030 USD לבקשה)
    • נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
  3. אפשר לקרוא לפונקציה findCurrentPlace() (Android) או findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (ל-iOS) ולציין שדות מכל שלוש הקטגוריות של סוגי הנתונים. בחשבון יופיעו המק"טים הבאים (בעת הצגת החיוב לפי מק"ט):
    • איתור המקום הנוכחי (המחיר החל מ- 0.030 USD לבקשה)
    • נתונים בסיסיים (חיוב של 0.00 USD)
    • נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
    • נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)

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

מק"ט של תמונה של מקום מחויב בסכום הזה:

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

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

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

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

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

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

כך מציגים או משנים את מגבלות המכסה ל-SDK של מקומות ל-Android:

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

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

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