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

שגיאה: kGMSPlacesRateLimitExceeded

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • סשן השלמה אוטומטית הסתיים בקריאה למק"ט: אימות כתובת מועדף.

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

טווח נפח חודשי
(מחיר לשיחה)
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: פרטי מקום (מזהים בלבד)

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

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName, GMSPlacePropertyPhotos

טווח נפח חודשי
(מחיר לשיחה)
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)

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

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

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyFormattedAddress, GMSPlacePropertyCoordinate, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyViewport

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

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

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

iOS: GMSPlacePropertyBusinessStatus, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyWheelchairAccessibleEntrance

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001-500,000 יותר מ-500,000
0.020 USD לכל
(20.00 USD לכל 1,000)
0.016 דולר ארה"ב לכל
(16.00 דולר ארה"ב לכל 1000)
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001-500,000 יותר מ-500,000
0.025 דולר ארה"ב לכל
(25.00 דולר ארה"ב לכל 1,000)
0.020 USD לכל
(20.00 USD לכל 1,000)
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyCoordinate, GMSPlacePropertyFormattedAddress, GMSPlacePropertyName, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyPhotos, GMSPlacePropertyPlaceID, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

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

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

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

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

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

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

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

iOS: GMSPlacePropertyPlaceID, GMSPlacePropertyName

טווח נפח חודשי
(מחיר לשיחה)
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: חיפוש טקסט (בסיסי)

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

iOS: GMSPlacePropertyAddressComponents, GMSPlacePropertyBusinessStatus, GMSPlacePropertyFormattedAddress, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyCoordinate, GMSPlacePropertyPhotos, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyViewport, GMSPlacePropertyWheelchairAccessibleEntrance

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite

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

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

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

iOS: GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

טווח נפח חודשי
(מחיר לשיחה)
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 ל-iOS

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

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

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

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

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

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

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

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

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

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

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


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

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

  • 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)
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

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

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

  • 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: השלמה אוטומטית – לפי בקשה

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

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

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

טווח נפח חודשי
(מחיר לבקשה)
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:
  • שירות אינטרנט: בקשה של פרטי מקום

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

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

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

בקשות לרענון מזהה פרטי מקום (בקשות המציינות רק את השדה 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 או שירות: שולחים בקשה ל'פרטי מקום' ומציינים את כל השדות (סוג זה ברירת המחדל אם לא מציינים שדות היא הבקשה: 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 ו/או אטמוספרה), בהתאם לשדות שצוינו בשיחה. כדי להגביל את התשובה רק לשדות האלה, צריך לציין שדות נתונים. אתם מחויבים על 'איתור נוכחי' מבצעים את השיחה ומציינים את הנתונים המבוקשים.

דוגמאות

  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)
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות

מגבלות שימוש נוספות

אין מספר מקסימלי של בקשות ליום, אבל הפרטים הבאים מגבלת השימוש עדיין חלה כשמשתמשים ב-Places SDK ל-iOS:

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

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

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

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

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

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

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

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