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

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

שגיאה: 9005‏ PLACES_API_RATE_LIMIT_EXCEEDED

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

איך מתבצע החיוב על Places SDK ל-Android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

החיוב מתבצע גם אם אתם משתמשים באסימוני סשן, ובמקרים הבאים:

כדי לסיים את הסשנים, שולחים בקשה אחת ל-Place Details (New) שבה מבקשים את כל השדות שמוגדרים על ידי SKU: Place Details (Location Only).
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
כדי לסיים את הסשן או לבטל אותו, צריך לבצע קריאה ל-SKU: Place Details (IDs Only). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות SKU: Autocomplete Requests.

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

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

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

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

סשן ההשלמה האוטומטית הסתיים על ידי קריאה ל-SKU: Place Details (Location Only):
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Place Details (Basic, Advanced, or Preferred).

קריאה לקבלת פרטי מקום שמבקשת כל שדה מ-מק"ט: פרטי מקום (בסיסי, מתקדם או מועדף) מחויבת לפי מק"ט: פרטי מקום (מועדף).
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Address Validation Preferred.

הערה: אם מבצעים קריאה ל-SKU: Place Details (Location Only) ואז קריאה ל-SKU: Address Validation Preferred לפני שתוקף אסימון הסשן יפוג, לא תחויבו על הקריאה ל-SKU: Place Details (Location Only) והסשן שלכם יחויב רק על הקריאה ל-SKU: Address Validation Preferred.

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

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

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

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

Android: Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME

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

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

Android: Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS
Place.Field.LOCATION
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

שדות שיצאו משימוש: השדות Place.Field.ADDRESS ו-Place.Field.LAT_LNG הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-Place.Field.FORMATTED_ADDRESS וב-Place.Field.LOCATION, בהתאמה.

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

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

Android: Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.BUSINESS_STATUS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

שדות שיצאו משימוש: השדות Place.Field.ICON_URL ו-Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-Place.Field.ICON_MASK_URL וב-Place.Field.ACCESSIBILITY_OPTIONS, בהתאמה. האפשרות Place.Field.ACCESSIBILITY_OPTIONS זמינה רק לפרטי המקום (חדש).

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

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

Android: Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI

שדות שיצאו משימוש:השדות Place.Field.PHONE_NUMBER ו-Place.Field.USER_RATINGS_TOTAL הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-Place.Field.INTERNATIONAL_PHONE_NUMBER וב-Place.USER_RATING_COUNT, בהתאמה.

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

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

Android: Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
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 USD לכל (25.00 USD ל-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.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
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 USD לכל (32.00 USD ל-1,000)	0.0256 USD לכל (25.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.035 USD לכל (35.00 USD ל-1,000)	0.028$ לכל (28.00$ ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.040 USD לכל ‏(40.00 USD ל-1,000)	0.032 USD לכל (32.00 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: חיפוש טקסט (מזהה בלבד)

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

Android: Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.RESOURCE_NAME

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

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

Android: Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.LOCATION
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.SUB_DESTINATIONS
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT

שדות שהוצאו משימוש: השדות Place.Field.ADDRESS,‏ Place.Field.ICON_URL,‏ Place.Field.LAT_LNG ו-Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-Place.Field.FORMATTED_ADDRESS, ב-Place.Field.ICON_MASK_URL, ב-Place.Field.LOCATION וב-Place.ACCESSIBILITY_OPTIONS, בהתאמה. האפשרות Place.Field.ACCESSIBILITY_OPTIONS זמינה רק לפרטי מקום (חדש).

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

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.035 USD לכל (35.00 USD ל-1,000)	0.028$ לכל (28.00$ ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.040 USD לכל ‏(40.00 USD ל-1,000)	0.032 USD לכל (32.00 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: Place Photo

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.007 USD לכל (7.00 USD ל-1,000)	0.0056 USD לכל (5.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android: Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT או Place.Field.UTC_OFFSET.

הערה: השדות Place.Field.ADDRESS,‏ Place.Field.ICON_URL,‏ Place.Field.LAT_LNG,‏ Place.Field.NAME ו-Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אפשר להשתמש ב-Place.Field.FORMATTED_ADDRESS, ב-Place.Field.ICON_MASK_URL, ב-Place.Field.LOCATION, ב-Place.Field.DISPLAY_NAME וב-Place.ACCESSIBILITY_OPTIONS, בהתאמה. השדה Place.Field.ACCESSIBILITY_OPTIONS זמין רק לפרטי מקום (חדש).

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
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD	עלות הבקשה להצגת המלונות ב-Google + 0.00 USD	עלות הבקשה להצגת המלונות ב-Google + 0.00 USD

מק"ט: פרטי איש קשר

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

Android: Place.Field.CURRENT_OPENING_HOURS,‏Place.Field.INTERNATIONAL_PHONE_NUMBER,‏Place.Field.OPENING_HOURS,‏Place.Field.SECONDARY_OPENING_HOURS או Place.Field.WEBSITE_URI

הערה: השדה Place.Field.PHONE_NUMBER יצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אתם צריכים להשתמש ב-Place.Field.INTERNATIONAL_PHONE_NUMBER.

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
עלות הבקשה ל-Places + 0.003$ לכל בקשה (+ 3.00$ לכל 1,000 בקשות)	עלות הבקשה ל-Places + 0.0024 דולר ארה"ב לכל בקשה (+ 2.40 דולר ארה"ב ל-1,000 בקשות)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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_RATING_COUNT‏
‏
‏ הערה: השדה Place.Field.USER_RATINGS_TOTAL הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אתם צריכים להשתמש ב-Place.Field.USER_RATING_COUNT.
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 בקשות)	עלות הבקשה ל-Places + 0.004 דולר ארה"ב לכל בקשה (+ 4.00 דולר ארה"ב ל-1,000 בקשות)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

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

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

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

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

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

טווח נפח חודשי (מחיר לכל סשן)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.017 USD לכל (17.00 USD ל-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)
בקשה להשלמה אוטומטית של מקום (input=”paris”, session_token: XYZ)

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

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

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

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

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

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

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

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

בקשות לרענון מזהה של פרטי מקום (בקשות שמציינות רק את השדה place_id) במהלך סשן של השלמה אוטומטית מחוייבות כ-SKU: Autocomplete without Place Details – Per 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?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (כולל מזהה המקום והשדה GMSPlaceFieldFormattedAddress)

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

בקשה להשלמה אוטומטית של מקומות (input=”par”, session_token: XYZ)
בקשה להשלמה אוטומטית של מקומות (input=”paris”, session_token: XYZ)
פרטי מקומות (place_id, ‏ session_token: ‏ XYZ, ‏ fields:‏formatted_address)

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

השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן (החיוב הוא 0.00$)
פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
נתונים בסיסיים (החיוב הוא 0.00$)

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

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

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

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

Android: Places SDK ל-Android (fetchPlace())
iOS: Places SDK ל-iOS (fetchPlaceFromPlaceID:)
JavaScript: שירות פרטי המקומות של Maps JavaScript API (getDetails)
JavaScript: ווידג'ט של מילוי אוטומטי של מקומות ב-Maps JavaScript API (getPlace)
JavaScript: ווידג'ט של תיבת חיפוש מקומות ב-Maps JavaScript API: ה-method‏ getPlaces() אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדיל), כפי שמוצג כאן:

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

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

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

דוגמאות

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

מק"ט: Find Current Place

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

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

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

דוגמאות

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

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

מק"ט של תמונה ב-Places מחויב על:

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

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

טווח נפח שיחות חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.007 USD לכל (7.00 USD ל-1,000)	0.0056 USD לכל (5.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

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

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

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

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

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

שגיאה: 9005‏ PLACES_API_RATE_LIMIT_EXCEEDED

איך מתבצע החיוב על Places SDK ל-Android

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

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

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

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

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

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

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

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

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

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

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

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

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

מק"ט: חיפוש טקסט (מזהה בלבד)

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

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

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

מק"ט: Place Photo

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

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

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

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

מק"ט: פרטי איש קשר

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

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

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

דוגמה

Android

iOS

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

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

דוגמה

Android

iOS

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

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

דוגמאות

מק"ט: Find Current Place

דוגמאות

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

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

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

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