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

תזכורת: כדי להשתמש ב-Places SDK ל-Android, צריך לכלול מפתח API לכל הבקשות של ה-API, ולהפעיל את החיוב בכל אחד מהפרויקטים.

שגיאה: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

הודעה: אם באפליקציה שלך ל-Android יש 9005 PLACES_API_RATE_LIMIT_EXCEEDED שגיאות, יכול להיות שאתה משתמש בגרסה שהוצאה משימוש של Places SDK ל-Android. גרסת Google Play Services של Places SDK ל-Android (לדוגמה com.google.android.gms:play-services-places) הוצאה משימוש ב-29 בינואר 2019 והושבתה ב-29 ביולי 2019. גרסה חדשה של Places SDK ל-Android זמינה עכשיו. מומלץ לעדכן לגרסה החדשה בהקדם האפשרי. פרטים נוספים זמינים במדריך להעברת נתונים.

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

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

Places SDK ל-Android גרסה 3.3.0 תומך בשתי גרסאות SDK: Places SDK for Android ו-Places SDK for Android (New), הגרסה הבאה של ה-SDK. על מנת לקרוא על ההבדלים העיקריים בין שתי גרסאות ה-SDK, ראו בחירת גרסת ה-SDK.

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

התמחור עבור השלמה אוטומטית של מקומות ו'המקום הנוכחי' זהה בשתי ערכות ה-SDK.

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

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

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

תמחור עבור Places SDK עבור Android (חדש)

מידע על אנונימיזציה של שדות

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

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

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

הערה:אם בוחרים שדות מהמק"ט ב-Place Details (Location בלבד), תחויבו בתעריף הזה. אם בוחרים שדות מהמק"ט של פרטי המקום (בסיסי), תחויבו בתעריף הזה. אם בוחרים שדות מהמק"ט ב-Place Details (מתקדם), תחויבו בתעריף הזה. אם תבחרו שדות מהמק"ט של Place Details (Preferred), תחויבו בתעריף הזה.

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

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

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

---

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

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

הערה: אם בוחרים שדות מהמק"ט של פרטי המקום (בסיסי), תחויבו בתעריף הזה. אם בוחרים שדות מהמק"ט ב-Place Details (מתקדם), תחויבו בתעריף הזה. אם תבחרו שדות מהמק"ט של Place Details (Preferred), תחויבו בתעריף הזה.

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

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

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

---

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

הערה: אם בוחרים שדות מהמק"ט ב-Place Details (מתקדם), תחויבו בתעריף הזה. אם תבחרו שדות מהמק"ט של Place Details (Preferred), תחויבו בתעריף הזה.

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

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

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

---

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

הערה: אם בוחרים שדות מהמק"ט ב-Place Details (Preferred), אתם מחויבים בתעריף הזה.

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

Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

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

---

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

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

Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

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

---

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

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

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

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

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

---

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

הערה: אם בוחרים שדות מהמק"ט של Text Search (מתקדם), תחויבו בתעריף הזה. אם תבחרו שדות מהמק"ט של Text Search (Preferred), תחויבו בתעריף הזה.

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

Android: Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.LAT_LNG, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.UTC_OFFSET, Place.Field.VIEWPORT, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

---

מק"ט: Text Search (מתקדם)

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

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

Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

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

---

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

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

Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

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

---

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

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

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

---

תמחור עבור Places SDK עבור Android

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

• Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET או Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
• iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes, או GMSPlaceFieldViewport
• שירות אינטרנט: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity או wheelchair_accessible_entrance

טווח נפח חודשי (מחיר לשיחה)
0-100,000	100,001–500,000	יותר מ-500,000
עלות של בקשת מקומות + 0.00 USD	עלות של בקשת מקומות + 0.00 USD	עלות של בקשת מקומות + 0.00 USD

---

מק"ט: נתוני איש קשר

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

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

• Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS או Place.Field.WEBSITE_URI
• iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber או GMSPlaceFieldWebsite
• שירות אינטרנט: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours או website

טווח נפח חודשי (מחיר לשיחה)
0-100,000	100,001–500,000	יותר מ-500,000
עלות של בקשת מקומות + 0.003 USD לכל אחד (+ 3.00 USD ל-1,000)	העלות של בקשת מקומות + 0.0024 USD לכל אחד (+ 2.40 USD ל-1,000)	כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

---

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

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

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

• 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$ לכל אחד (+ 4.00 USD ל-1,000)	כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

---

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

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

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

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

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

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

---

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

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

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

דוגמה

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

Android

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

iOS

• placesClient?.findcompletedictions(fromQuery: "par" ...
• placesClient?.findCompletePredictions(fromQuery: "paris" ...

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

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

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

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

---

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

הערה: המק"ט הזה מופיע בדוחות החיוב, אבל לא בדף Billing > Pricing במסוף Google Cloud.

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

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

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

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

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

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

טווח נפח חודשי (מחיר לכל הפעלה)
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?.findcompletedictions(fromQuery: "par" ...
• placesClient?.findCompletePredictions(fromQuery: "paris" ...
• fetchPlaceFromPlaceID: (כולל את מזהה המקום והשדה GMSPlaceFieldFormattedAddress)

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

• בקשה להשלמה אוטומטית של מקומות (input=”par”, session_token: XYZ)
• בקשה להשלמה אוטומטית של מקומות (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 USD לכל (17.00 USD לכל 1000)	0.0136$ לכל (13.60 USD לכל 1000)	כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

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

  

  בתוצאות של הווידג'ט של תיבת החיפוש, אחרי הקלדת המילה "פיצה" בתיבת החיפוש, ניתן לראות ש-Pizza Autentico} מופיע לצד תוצאה 1 (שמופיעה לידו סמל סיכה1{/0) ולא* שאילתה (סמל: זכוכית מגדלת).

• שירות אינטרנט: שירות פרטי מקום של API

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

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

דוגמאות

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

---

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

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

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

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

דוגמאות

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

---

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

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

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

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

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

---

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

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

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

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

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

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

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

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

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

• חיוב ותמחור בפלטפורמה של מפות Google
• דיווח ומעקב בפלטפורמה של מפות Google

---

1. על מנת לקבל את הקרדיט לפלטפורמה של מפות Google, המשתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני שהם יוצרים חשבון לחיוב בפלטפורמה של מפות Google.↩