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

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

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

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

סשן של השלמה אוטומטית (חדשה) כולל בקשה אחת או יותר של השלמה אוטומטית (חדשה), ובקשה של Place Details (חדשים) או בקשה של Address Validation. אותו טוקן סשן מועבר לבקשה של השלמה אוטומטית (חדשה) ולבקשה הבאה של Place Details (חדשים) או לבקשה של Address Validation.

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

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

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

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

פרטי מק"ט ותמחור של Places SDK ל-Android

בטבלה הבאה מפורטים המק"טים של Places SDK ל-Android עם תשלום לפי שימוש, והמחירים שלהם.

קטגוריה	פרטי מק"ט של Places SDK ל-Android (חדש)	תמחור מק"טים
‫Essentials	SKU: Autocomplete Requests	מחירון גלובלי מחירון להודו
‫Essentials	‫SKU: Autocomplete Session Usage	מחירון גלובלי מחירון להודו
‫Essentials	מק"ט: Place Details Essentials (מזהים בלבד)	מחירון גלובלי מחירון להודו
‫Essentials	‫SKU: Places UI Kit Query	מחירון גלובלי מחירון להודו
‫Essentials	SKU: Places UI Kit - Autocomplete Per Session	מחירון גלובלי מחירון להודו
‫Essentials	מק"ט: Place Details Essentials	מחירון גלובלי מחירון להודו
‫Essentials	SKU: Text Search Essentials (IDs Only)	מחירון גלובלי מחירון להודו
Pro	מק"ט: חיפוש בסביבה Pro	מחירון גלובלי מחירון להודו
Pro	מק"ט: Place Details Pro	מחירון גלובלי מחירון להודו
Pro	מק"ט: Places UI Kit Pro	מחירון גלובלי מחירון להודו
Pro	מק"ט: חיפוש טקסט Pro	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: חיפוש בסביבה Enterprise	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: חיפוש בסביבה Enterprise Plus	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: פרטי מקומות – Enterprise	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: Place Details Enterprise + Atmosphere	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: חיפוש טקסט Enterprise	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: חיפוש טקסט Enterprise + Atmosphere	מחירון גלובלי מחירון להודו
‫Enterprise	מק"ט: תמונות בפרטי המקום	מחירון גלובלי מחירון להודו
קטגוריה	פרטי מק"ט של Places SDK ל-Android (מדור קודם)	תמחור מק"טים
‫Essentials	SKU: Autocomplete - Per Request	מחירון גלובלי מחירון להודו
‫Essentials	מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן	מחירון גלובלי מחירון להודו
‫Essentials	‫SKU: Basic Data חיובים נוספים: מק"ט: פרטי מקומות SKU: Find Current Place	מחירון גלובלי מחירון להודו
Pro	מק"ט: השלמה אוטומטית ללא Places Details – לכל סשן	מחירון גלובלי מחירון להודו
Pro	SKU: Find Current Place חיובים נוספים: ‫SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	מחירון גלובלי מחירון להודו
Pro	מק"ט: פרטי מקומות חיובים נוספים: ‫SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	מחירון גלובלי מחירון להודו
‫Enterprise	SKU: Atmosphere Data חיובים נוספים: מק"ט: פרטי מקומות SKU: Find Current Place	מחירון גלובלי מחירון להודו
‫Enterprise	SKU: Contact Data חיובים נוספים: מק"ט: פרטי מקומות SKU: Find Current Place	מחירון גלובלי מחירון להודו
‫Enterprise	SKU: Place Photos	מחירון גלובלי מחירון להודו

מכסות שימוש

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

המכסה של שיטות Places SDK ל-Android (חדש) מבוססת על Places API (חדש), והמכסה של שיטות Places SDK ל-Android מבוססת על Places API (מדור ישן).

• ‫Places API (חדש): המגבלה היא לכל שיטת API לכל פרויקט. כלומר, לכל method של API יש מכסה נפרדת.
• ‫Places API (מדור קודם): יש רק מגבלה אחת, והיא חלה על הסכום של כל שיטות ה-API.

אסטרטגיות חסכוניות לשימוש ב-Places API

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

שימוש במסכות שדות

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

בבקשות של Place Details (New),‏ חיפוש בסביבה (New) ו-חיפוש טקסט (New), צריך להשתמש במסכת שדות כדי לציין את רשימת השדות שיוחזרו בתשובה.

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

שימוש בתמחור לפי סשן עם Place Details (חדש)

אם נפח הקריאות החודשי באפליקציות שלכם הוא 100,001 עד 500,000 או יותר, או אם המשתמשים שולחים יותר מ-12 בקשות להשלמה אוטומטית בכל סשן, Google ממליצה להשתמש בסשנים עם השלמה אוטומטית (חדש). הסשנים עוזרים לפשט את התמחור ומספקים מודל תמחור עקבי לשימוש עם השלמה אוטומטית (חדשה).

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

שינוי המכסה

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

חשוב: כדי להבין איך הגדלת המכסה יכולה להשפיע על החשבון, כדאי לעיין במחשבון התמחור.

כדי לשנות את ערך המכסה של ה-API, פועלים לפי השלבים הבאים:

1. במסוף Cloud, עוברים אל Google Maps Platform > מכסות.
2. בוחרים את ה-API שרוצים לשנות את המכסה שלו.
3. מזהים את ערך המכסה שרוצים לשנות ומסמנים את התיבה שלידו.
4. לוחצים על עריכה, מזינים ערך מכסה חדש ולוחצים על שליחת בקשה.

הצגה של בקשות להגדלת מכסות

חשוב: כדי לראות את הבקשות להגדלת מכסות, צריך את הרשאות ה-IAM המתאימות.

כדי לראות את כל הבקשות להגדלת מכסות, כולל בקשות קודמות ובקשות בהמתנה:

1. במסוף Cloud, עוברים אל Google Maps Platform > מכסות.
2. בוחרים את ה-API שרוצים לראות את הבקשה להגדלת המכסה שלו.
3. לוחצים על Increase Requests.

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

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

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

---