Places SDK לשימוש ולחיוב ב-Android

שגיאה: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

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

אופן החיוב של Places SDK ל-Android

Places SDK ל-Android (חדש) ו-Place SDK ל-Android משתמשים במודל תמחור של תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע לפי מק"טים. מתבצע מעקב אחרי השימוש לכל מק"ט, ולכל API או SDK יכול להיות יותר ממק"ט אחד של מוצר. העלות מחושבת לפי:

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

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

התמחור של Places SDK ל-Android (חדש)

מידע על מסיכות שדות

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

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

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

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

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

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

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

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

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

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

  • לסיים את הסשנים באמצעות בקשה אחת לפרטי מקום (חדש) שמבקשת שדות כלשהם שהוגדרו על ידי מק"ט: פרטי מקום (מיקום בלבד).
    • כל בקשה להשלמה אוטומטית (חדשה) מחויבת ב-12 בקשות (לכל היותר) באמצעות SKU: parallel requests.
    • כל בקשה נוספת להשלמה אוטומטית (חדשה) מחויבת באמצעות SKU: השלמה אוטומטית בשימוש.
    לא מחויבת, והסשן מחויב לפי SKU: Complete Session Usage (שימוש בהשלמה אוטומטית).
  • יוצאים מהסשן או מסיימים את הסשן באמצעות קריאה למק"ט: פרטי מקום (מזהים בלבד). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות SKU: Inventory requests.
  • טווח נפח חודשי
    (מחיר לשיחה)
    0-100,000 100,001-500,000 יותר מ-500,000
    0.00283 דולר ארה"ב לכל
    (2.83 דולר ארה"ב לכל 1,000)
    0.00227 דולר ארה"ב לכל
    (2.27 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

    SKU: שימוש בסשנים של השלמה אוטומטית

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

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

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

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

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

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

    למידע נוסף ראו השלמה אוטומטית (חדש) ותמחור סשנים.

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

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

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

    Android: Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

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

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

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

    Android: Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

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

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

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

    Android: Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

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

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.020 USD לכל
    (20.00 USD לכל 1,000)
    0.016 דולר ארה"ב לכל
    (16.00 דולר ארה"ב לכל 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-100,000 100,001-500,000 יותר מ-500,000
    0.025 דולר ארה"ב לכל
    (25.00 דולר ארה"ב לכל 1,000)
    0.020 USD לכל
    (20.00 USD לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

    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.ID, Place.Field.NAME, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

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

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.035 דולר ארה"ב לכל
    (35.00 דולר ארה"ב לכל 1,000)
    0.028 דולר ארה"ב לכל
    (28.00 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.040 דולר ארה"ב לכל
    (40.00 דולר ארה"ב לכל 1,000)
    0.032 דולר ארה"ב לכל
    (32.00 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

    SKU: Text Search (מזהה בלבד)

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

    Android: Place.Field.ID, Place.Field.NAME

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

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

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.032 דולר ארה"ב לכל
    (32.00 דולר ארה"ב לכל 1,000)
    0.0256 דולר ארה"ב לכל
    (25.60 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

    SKU: חיפוש טקסט (מתקדם)

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.035 דולר ארה"ב לכל
    (35.00 דולר ארה"ב לכל 1,000)
    0.028 דולר ארה"ב לכל
    (28.00 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

    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-100,000 100,001-500,000 יותר מ-500,000
    0.040 דולר ארה"ב לכל
    (40.00 דולר ארה"ב לכל 1,000)
    0.032 דולר ארה"ב לכל
    (32.00 דולר ארה"ב לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

    מק"ט: תמונת מקום

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

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

    התמחור של Places SDK ל-Android

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

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

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

    ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-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-100,000 100,001-500,000 יותר מ-500,000
    עלות של בקשת מקומות
    + 0.00 USD
    עלות של בקשת מקומות
    + 0.00 USD
    עלות של בקשת מקומות
    + 0.00 USD

    מק"ט: נתונים ליצירת קשר

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

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

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

    באמצעות פרמטר השדות בבקשה של 'פרטי המקום' או של 'חיפוש מקום', אפשר להגביל את התשובות רק לשדות שצוינו. שדות בקטגוריה 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-100,000 100,001-500,000 יותר מ-500,000
    עלות של בקשת מקומות
    + 0.005 דולר ארה"ב לכל
    (+ 5.00 דולר ארה"ב לכל 1,000)
    עלות של בקשת מקומות
    + 0.004 USD לכל
    (+ 4.00 USD לכל 1,000)
    לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

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

    בקשות להשלמה אוטומטית מהווידג'ט של השלמה אוטומטית במקום JavaScript של Maps API עשויות להיות כרוכות בתשלום השלמה אוטומטית – מק"ט לפי בקשה במקרה שקריאות מתבצעות מסשן לא חוקי של השלמה אוטומטית. מצב כזה יכול לקרות כאשר משתמש מקליד מספר כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט, ולא תמיד בוחר חיזוי להשלמה אוטומטית.

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

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

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

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

    דוגמה

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

    Android

    iOS

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

    בחיוב יופיע המק"ט הזה (בצפייה בחיוב לפי מק"ט):

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

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

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

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

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

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

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

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

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

    דוגמה

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

    Android

    iOS

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

    בחיוב יופיעו המק"טים הבאים (בצפייה בחיוב לפי מק"ט):

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

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

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

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

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

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

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

    דוגמאות

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

    מק"ט: חיפוש המקום הנוכחי

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

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

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

    דוגמאות

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

    מק"ט: תמונת מקום

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

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

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

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

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

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

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

    כדי להציג או לשנות את מגבלות המכסה של Places SDK ל-Android:

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

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