שגיאה: 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 של הפלטפורמה של מפות Google החיוב על ערכות SDK מתבצע לפי מק"טים. מתבצע מעקב אחר השימוש לכל מק"ט, ולכל API או SDK יכול להיות יותר המק"ט של המוצר. העלות מחושבת לפי:
היעזרו בכלי התמחור ומחשבון שימוש כדי להעריך את עלות השימוש לכל API או SDK. לעמידה בדרישות מק"טים של פלטפורמת מפות Google, זיכוי בסך 200 דולר ארה"ב לפלטפורמה של מפות Google בכל חודש לכל חשבון לחיוב. הזיכוי הזה נוסף באופן אוטומטי שחל על המק"טים המתאימים.
התמחור של Places SDK ל-Android (חדש)
מידע על מסיכות שדות
משתמשים במסכות של שדות, שנקראות גם רשימות שדות, בבקשות כדי לציין את הרשימה שדות שיחזרו בתשובה. לאחר מכן נחייב אתכם במק"ט הגבוה ביותר הרלוונטי לבקשה שלך. כלומר, אם תבחרו שדות גם בתבנית (בסיסית) המק"ט והמק"ט (מתקדם) מחויבים לפי המק"ט (מתקדם).
שימוש במסכת שדה הוא שיטה טובה להימנע מבקשה נתונים לא נחוצים, וכך למנוע זמן עיבוד וחיוב מיותרים. חיובים.
מידע על סשנים של השלמה אוטומטית (חדשים)
סשן של השלמה אוטומטית (חדש) כולל בקשת השלמה אוטומטית (חדשה) אחת או יותר בקשה לפרטי מקום (חדש) או בקשה לאימות כתובת. אותו אסימון סשן מועבר אל בקשת השלמה אוטומטית (חדשה) ולבקשה הבאה של פרטי מקום (חדש) או אימות כתובת בקשה.
סשן מתחיל בבקשה הראשונה של השלמה אוטומטית (חדש). בקשה לקבלת פרטי מקום (חדש) או לאחר מכן, הבקשה לאימות כתובת נשלחת כשהמשתמש בוחר באחת מהאפשרויות של השלמה אוטומטית (חדש) הצעות. אם סשן ננטש, כלומר אין בקשה לפרטי מקום (חדש) או נשלחה בקשה לאימות כתובת, בקשות להשלמה אוטומטית (חדש) מחויבות כאילו אין אסימון סשן שניתנו.
לאחר שהמשתמש בחר מקום (כלומר בקשה לקבלת פרטי מקום (חדש) או אימות כתובת כשבוצעה בקשה), עליך להתחיל סשן חדש באמצעות אסימון סשן חדש.
אסימון סשן מתאים לסשן אחד ולא ניתן להשתמש בו ליותר מסשן אחד סשן. אם אתם משתמשים שוב באסימון סשן, הסשן נחשב ללא תקין והבקשות מחויב כאילו לא סופק אסימון סשן.
מק"ט: בקשות להשלמה אוטומטית
מק"ט של בקשות להשלמה אוטומטית מחויב עבור כל בקשה ממשק API להשלמה אוטומטית (חדש) שלא כולל אסימון סשן.
הוא מחויב גם אם משתמשים באסימוני סשן וגם אם:
- לסיים את הסשנים באמצעות בקשה יחידה לפרטי מקום (חדש)
מבקשת כל שדה שמוגדר על ידי SKU: פרטי מקום (מיקום בלבד).
- כל בקשה להשלמה אוטומטית (חדשה) מחויבת ב-12 בקשות לכל היותר באמצעות מק"ט: בקשות להשלמה אוטומטית.
- כל בקשה נוספת להשלמה אוטומטית (חדשה) מחויבת באמצעות SKU: השלמה אוטומטית של שימוש בסשנים.
- אפשר לעזוב את הסשן או לסיים את הסשן SKU: פרטי מקום (מזהים בלבד). לאחר מכן יתבצע חיוב של כל הבקשות להשלמה אוטומטית (חדשות) באמצעות SKU: פונקציית השלמה אוטומטית.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב לכל 1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: שימוש בסשנים של השלמה אוטומטית
מק"ט של שימוש בהשלמה אוטומטית מחויב עבור כל בקשה ממשק API להשלמה אוטומטית (חדש) שכולל אסימון סשן.
המק"ט מחויב בתרחישים הבאים:
סשן השלמה אוטומטית הסתיים בעקבות קריאה למק"ט: פרטי מקום (מיקום בלבד):
- כל בקשה להשלמה אוטומטית (חדשה) מחויבת ב-12 בקשות לכל היותר באמצעות מק"ט: בקשות להשלמה אוטומטית.
- כל בקשה נוספת להשלמה אוטומטית (חדשה) מחויבת באמצעות SKU: השלמה אוטומטית של שימוש בסשנים.
סשן השלמה אוטומטית הסתיים בקריאה למק"ט: פרטי מקום (בסיסי, מתקדם או מועדף).
קריאה ל'פרטי מקום' שמבקשת כל שדה החיוב על מק"ט: פרטי מקום (בסיסי, מתקדם או מועדף) הוא מק"ט: פרטי מקום (מועדף).
סשן השלמה אוטומטית הסתיים בקריאה למק"ט: אימות כתובת מועדף.
מידע נוסף זמין במאמר הבא: השלמה אוטומטית (חדש) ותמחור סשנים.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 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.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.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.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.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.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.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.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.040 דולר ארה"ב לכל (40.00 דולר ארה"ב לכל 1,000) |
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: Text Search (מזהה בלבד)
באמצעות מסכת שדות או רשימת שדות בבקשה של 'חיפוש טקסט (חדש)', אפשר להגביל תגובה רק לשדות שצוינו. הזה מק"ט מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ID,
Place.Field.NAME
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 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.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.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.040 דולר ארה"ב לכל (40.00 דולר ארה"ב לכל 1,000) |
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: תמונת מקום
מק"ט של תמונת מקום מחויב על כל בקשה ל-API.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| 0.007 דולר ארה"ב לכל (7.00 דולר ארה"ב לכל 1,000) |
0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב לכל 1000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
התמחור של Places SDK ל-Android
מידע על סשנים עם השלמה אוטומטית
סשן של השלמה אוטומטית כולל כמה בקשות להשלמה אוטומטית (לאחזור הצעות במקום שהמשתמש מקליד), ולכל היותר בקשה אחת לפרטי מקומות (כדי לאחזר פרטים על המקום שהמשתמש בחר). אותו אסימון סשן מועבר להשלמה האוטומטית לאחר מכן. סשן מתחיל בבקשת ההשלמה האוטומטית הראשונה (שמתחילה קורה בדרך כלל כשהמשתמש מתחיל להקליד). מתבצעת קריאה ל'פרטי מקומות' כשהמשתמש בחר באחת מההצעות להשלמה אוטומטית. אם משתמש לא בוחר הצעה, לא מתבצעת שיחה מסוג 'פרטי מקומות'.
לאחר שמשתמש בחר מקום (כלומר, בוצעה קריאה ל'פרטי מקומות'), עליך להתחיל שיחה חדשה באמצעות אסימון סשן חדש.
ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-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.00 USD |
עלות של בקשת מקומות + 0.00 USD |
עלות של בקשת מקומות + 0.00 USD |
מק"ט: נתונים ליצירת קשר
שימוש בפרמטר של השדות בפרטי המקום או בבקשה ל'חיפוש מקום' לשירותי אינטרנט, או
מערך של Place.Field ל-Android או ל-iOS, אפשר
להגביל את התגובה רק לשדות שצוינו. שדות בקטע Contact
הקטגוריה עשויה להיות כרוכה בחיוב נוסף. המק"ט Contact Data מופעל
כשנשלחת בקשה לאחד מהשדות האלה:
-
Android:
Place.Field.CURRENT_OPENING_HOURS,Place.Field.OPENING_HOURS,Place.Field.PHONE_NUMBER,Place.Field.SECONDARY_OPENING_HOURS, אוPlace.Field.WEBSITE_URI -
iOS:
GMSPlaceFieldOpeningHours,GMSPlaceFieldPhoneNumberאוGMSPlaceFieldWebsite -
שירות אינטרנט:
formatted_phone_number,international_phone_number,opening_hours,current_opening_hours,secondary_opening_hours, אוwebsite
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| עלות של בקשת מקומות + 0.003 USD לכל (+ 3.00 USD לכל 1,000) |
עלות של בקשת מקומות + 0.0024 USD לכל (+ 2.40 USD לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
מק"ט: נתוני אטמוספירה
באמצעות הפרמטר של השדות בבקשה 'פרטי מקום' או 'חיפוש מקום', אפשר להגביל את התגובה רק לשדות שצוינו. שדות באטמוספירה הקטגוריה עשויה להיות כרוכה בחיוב נוסף. המק"ט של נתוני האטמוספירה הוא מופעלות כשנשלחת בקשה לאחד מהשדות הבאים:
- Android:
Place.Field.CURBSIDE_PICKUP,Place.Field.DELIVERY,Place.Field.EDITORIAL_SUMMARY,Place.Field.DINE_IN,Place.Field.PRICE_LEVEL,Place.Field.RATING,Place.Field.RESERVABLE,Place.Field.SERVES_BEER,Place.Field.SERVES_BREAKFAST,Place.Field.SERVES_BRUNCH,Place.Field.SERVES_DINNER,Place.Field.SERVES_LUNCH,Place.Field.SERVES_VEGETARIAN_FOOD,Place.Field.SERVES_WINE,Place.Field.TAKEOUTאוPlace.Field.USER_RATINGS_TOTAL - iOS:
GMSPlaceFieldPriceLevel,GMSPlaceFieldRating,GMSPlaceFieldUserRatingsTotal,GMSPlaceFieldTakeout,GMSPlaceFieldDelivery,GMSPlaceFieldDineIn,GMSPlaceFieldCurbsidePickup,GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast,GMSPlaceFieldServesLunch,GMSPlaceFieldServesDinner,GMSPlaceFieldServesBeer,GMSPlaceFieldServesWine,GMSPlaceFieldServesBrunchאוGMSPlaceFieldServesVegetarianFood. - JavaScript: ראו שדות (פרטי מקום)
- שירות אינטרנט:
curbside_pickup,delivery,dine_in,editorial_summary,price_level,rating,reservable,reviews,serves_beer,serves_breakfast,serves_brunch,serves_dinner,serves_lunch,serves_vegetarian_food,serves_wine,takeout, אוuser_ratings_total.
| טווח נפח חודשי (מחיר לשיחה) |
||
|---|---|---|
| עלות של בקשת מקומות + 0.005 דולר ארה"ב לכל (+ 5.00 דולר ארה"ב לכל 1,000) |
עלות של בקשת מקומות + 0.004 USD לכל (+ 4.00 USD לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: השלמה אוטומטית – לפי בקשה
המק"ט השלמה אוטומטית – לפי בקשה מחויב עבור כל אחת מהקריאות האלה בקשות שלא כוללות אסימון סשן:
- Android:
findAutocompletePredictions() - iOS:
findAutocompletePredictionsFromQuery: - JavaScript: שירות ההשלמה האוטומטית של מקומות ב-JavaScript API של מפות Google
- שירות אינטרנט: שירות השלמה אוטומטית למקומות API
קריאות שבוצעו מסשן לא חוקי של השלמה אוטומטית (לדוגמה, סשן שנעשה בו שימוש חוזר באסימון סשן) גם הם מחויבים בהשלמה אוטומטית – מק"ט לכל בקשה.
בקשות להשלמה אוטומטית מ- API של JavaScript במפות Google ייתכן שהווידג'ט 'השלמה אוטומטית' של המקום יחויב באמצעות השלמה אוטומטית – מק"ט לפי בקשה במקרה שמתבצעות קריאות מסשן לא חוקי של השלמה אוטומטית. מצב כזה יכול לקרות כשמשתמש מקליד כמה כתובות שונות או העתקה/הדבקה של כתובות שונות בווידג'ט, ולא תמיד בוחר חיזוי להשלמה אוטומטית.
| טווח נפח חודשי (מחיר לבקשה) |
||
|---|---|---|
| 0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב לכל 1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
SKU: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט השלמה אוטומטית ללא פרטי מקום – לכל סשן מחויב עבור סשן של השלמה אוטומטית לא כולל בקשה להוספת פרטי מקום (תוך כמה דקות מתחילת של הסשן).
| טווח נפח חודשי (מחיר ל-SESSION) |
||
|---|---|---|
| 0.017 דולר ארה"ב לכל (17.00 דולר ארה"ב לכל 1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב לכל 1,000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
דוגמה
אם האפליקציה שולחת את שתי הקריאות האלה בהפעלה אחת:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findcompletePredictions(fromQuery: "par" ...
- placesClient?.findcompletePredictions(fromQuery: "paris" ...
שירות אינטרנט
- שם הבקשה להשלמה אוטומטית במקום (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית במקום (input=”paris”, session_token: XYZ)
בחשבון שלכם, המק"ט יופיע הצגת החיוב לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל סשן (מחיר החל מ-0.017 דולר ארה"ב לסשן)
SKU: השלמה אוטומטית (כלולה עם פרטי מקום) – לכל סשן
השלמה אוטומטית (כלולה בפרטי מקום) – לכל סשן המק"ט מחויב על סשן של השלמה אוטומטית שכולל אחד או יותר מהרכיבים הבאים:
- Android: שיחה אל
fetchPlace() - iOS: קריאה ל-
fetchPlaceFromPlaceID: - שירות אינטרנט: בקשה של פרטי מקום
הבקשה להשלמה אוטומטית זמינה ללא תשלום, והשיחה הבאה מסוג 'פרטי המקום' תחויב לפי תמחור של פרטי המקום.
בקשה לקבלת פרטי מקום יוצרת מק"טים של נתונים (בסיסי, Contact או Atmosphere) – בהתאם לשדות שצוינו בבקשה.
אם לא תציינו שדות בבקשה של פרטי המקום, כל מק"טים של נתונים יופעלו (בסיסי, יצירת קשר ואווירה).
בקשות לרענון מזהה פרטי מקום (בקשות המציינות רק את השדה place_id)
במהלך פעילות של השלמה אוטומטית, החיוב מתבצע באמצעות SKU: השלמה אוטומטית
ללא פרטי מקום – לכל סשן.
| טווח נפח חודשי (מחיר ל-SESSION) |
||
|---|---|---|
| 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.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.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.007 דולר ארה"ב לכל (7.00 דולר ארה"ב לכל 1,000) |
0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב לכל 1000) |
לתמחור נפחי אחסון, צרו קשר עם מחלקת המכירות |
הגבלות על התנאים וההגבלות
לקבלת מידע על תנאים והגבלות, אפשר לעיין בקטע הקטע 'הגבלות על רישיונות' של התנאים וההגבלות של הפלטפורמה של מפות Google.
ניהול עלות השימוש
כדי לנהל את עלות השימוש ב-Place SDK ל-Android או כדי לעמוד בדרישות הייצור תנועה, להגדיר מגבלות מכסה יומיות על כל הבקשות לכל API. המכסות היומיות מתאפסות בשעה חצות לפי שעון החוף המערבי של ארה"ב.
כדי להציג או לשנות את מגבלות המכסה של Places SDK ל-Android:
- במסוף Cloud, פותחים את הדף מכסות בפלטפורמה של מפות Google.
- לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים באפשרות Places SDK for Android.
- כדי לראות את המגבלות במכסות, גוללים למטה לקטע בקשות.
של Google.
בטבלה מפורטות השמות והמגבלות של המכסות. - כדי לשנות מגבלת מכסה, לוחצים על סמל העריכה לצד אותה מכסה.
בתיבת הדו-שיח שמופיעה, בשדה מגבלת המכסה, מזינים את מגבלת מכסה יומית מועדפת לחיוב (עד מגבלת המכסה, אם קיימת, שצוינה על ידי Google) ובוחרים באפשרות שמירה.
אם השימוש שלכם ב-API יגיע למגבלת המכסה שניתנת לחיוב ביום נתון, האפליקציה לא יוכלו לגשת ל-API עד סוף היום.