דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

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

שירות השלמה אוטומטית של Place API או שירות ההשלמה האוטומטית של מקומות ב-JavaScript API של מפות Google. צריך לעצב כדי לספק אסימוני סשן (ייתכן שתצטרכו לשנות את הקוד הקיים).
ווידג'ט ההשלמה האוטומטית של Maps JavaScript 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: השלמה אוטומטית – לפי בקשה

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

Android: findAutocompletePredictions()
iOS: findAutocompletePredictionsFromQuery:
JavaScript: שירות ההשלמה האוטומטית של מקומות ב-JavaScript API של מפות Google
שירות אינטרנט: שירות השלמה אוטומטית למקומות API

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

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

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

findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

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

שם הבקשה להשלמה אוטומטית במקום (input=”par”, session_token: XYZ)
בקשה להשלמה אוטומטית של Place (input=”paris), session_token: XYZ)

בחשבון שלכם, המק"ט יופיע הצגת החיוב לפי מק"ט):

השלמה אוטומטית ללא פרטי מקום – לכל סשן (מחיר החל מ-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

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)

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

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

טווח נפח חודשי (מחיר לשיחה)
0-100,000	100,001-500,000	יותר מ-500,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: הווידג'ט 'השלמה אוטומטית במקום' ב-JavaScript API של מפות Google (getPlace)
JavaScript: הווידג'ט של Place SearchBox של Maps JavaScript API: getPlaces() אחרי שהמשתמש בוחר תוצאת מקום (סמל: סיכה), *לא* שאילתה (סמל: זכוכית מגדלת), כפי שמוצג כאן:

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

דוגמאות

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

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

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

Android: שיחות אל fetchPhoto()
iOS: שיחות למספר loadPlacePhoto:
JavaScript:אל ספריית מקומות, מפות JavaScript API להציב את שירות Photos כשמבקשים נתונים מכתובות ה-URL שהוחזרו על ידי PlacePhoto.getUrl() כדי לטעון נתוני פיקסלים של תמונה
שירות אינטרנט: בקשות מקום ב-Places API שירות Photos

בשירות 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:

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

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

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

שגיאה: kGMSPlacesRateLimitExceeded

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה

Android

iOS

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

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

דוגמה

Android

iOS

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

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

דוגמאות

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

דוגמאות

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

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

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

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

מקורות מידע שקשורים לניהול עלויות

שגיאה: `kGMSPlacesRateLimitExceeded`