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

החיוב על בקשות ל-Places API דרך Places SDK ל-iOS מתבצע לפי מק"ט.

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

מידע על סשנים של Autocomplete (New)

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

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

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

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

פרטי המק"טים והתמחור של Places SDK ל-iOS

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

קטגוריהפרטי המק"טים של Places SDK ל-iOS (חדש)תמחור מק"טים
Essentials מק"ט: Autocomplete Requests מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: שימוש בסשן של השלמה אוטומטית מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: Place Details Essentials (מזהים בלבד) מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Place Details Essentials מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Places UI Kit Query מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Places UI Kit – השלמה אוטומטית לסשן מחירון גלובלי
מחירון בהודו
Essentials מק"ט: חיפוש טקסט Essentials (IDs Only) מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש בסביבה Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: Place Details Pro מחירון גלובלי
מחירון בהודו
Pro ‫מק"ט: Places UI Kit (Advanced) מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש טקסט Pro מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise Plus מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט לארגונים מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט לארגונים + אווירה מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Photos מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"טים של Places SDK ל-iOS (דור קודם)תמחור מק"טים
Essentials מק"ט: Autocomplete – Per Request מחירון גלובלי
מחירון בהודו
Essentials מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן מחירון גלובלי
מחירון בהודו
Essentials

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

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Pro מק"ט: Autocomplete without Place Details – לכל סשן מחירון גלובלי
מחירון בהודו
Pro

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

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Pro

מק"ט: Places Details

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise

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

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise

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

חיובים נוספים:

מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Photos מחירון גלובלי
מחירון בהודו

מכסות שימוש

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

‫Places SDK ל-iOS (הגרסה החדשה) שולח שאילתות ל-Places API (הגרסה החדשה), ו-Places SDK ל-iOS (הגרסה הקודמת) שולח שאילתות ל-Places API. מגבלות המכסות שהוגדרו ב-Places API (החדש) וב-Places API חלות על הבקשות מה-SDK התואם.

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

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

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

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

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

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

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

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

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

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

שינוי המכסה

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

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

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

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

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

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

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

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