מקומות שימוש וחיוב ב-API

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

בגרסאות החדשות של Place Details, חיפוש בסביבה וחיפוש טקסט, משתמשים בכותרת FieldMask בבקשות ל-API כדי לציין את רשימת השדות שיוחזרו בתגובה. לאחר מכן תחויבו במק"ט הגבוה ביותר שרלוונטי לבקשה שלכם. כלומר, אם תבחרו שדות גם במק"ט Essentials וגם במק"ט Pro, תחויבו על סמך מק"ט Pro.

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

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

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

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

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

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

פרטי המק"טים והתמחור של Places API

בטבלה הבאה מוצגים פרטי המק"טים של Places API בתשלום לפי שימוש והמחירים שלהם.

קטגוריהפרטי המק"טים של Places API (חדש)תמחור מק"טים
Essentials מק"ט: בקשות להשלמה אוטומטית מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: שימוש בסשן של השלמה אוטומטית מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: Place Details Essentials (מזהים בלבד) מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Place Details Essentials מחירון גלובלי
מחירון בהודו
Essentials מק"ט: חיפוש טקסט Essentials (מזהים בלבד) מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש בסביבה Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: Place Details Pro מחירון גלובלי
מחירון בהודו
Pro מק"ט: חיפוש טקסט Pro מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש בסביבה – Enterprise + Atmosphere מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט ב-Enterprise מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: חיפוש טקסט לארגונים + אווירה מחירון גלובלי
מחירון בהודו
Enterprise מק"ט: Place Details Photos מחירון גלובלי
מחירון בהודו
קטגוריהפרטי המק"טים של Places API (דור קודם)תמחור מק"טים
Essentials מק"ט: Autocomplete – Per Request מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Autocomplete (כלול ב-Place Details) – לכל סשן מחירון גלובלי
מחירון בהודו
Essentials

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

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

מחירון גלובלי
מחירון בהודו
Essentials ‫מק"ט: Find Place – מזהה בלבד מחירון גלובלי
מחירון בהודו
Essentials מק"ט: Place Details Essentials – ID Refresh מחירון גלובלי
מחירון בהודו
Essentials מק"ט: השלמה אוטומטית של שאילתה – לכל בקשה מחירון גלובלי
מחירון בהודו
Pro מק"ט: Autocomplete without Place Details - Per Session מחירון גלובלי
מחירון בהודו
Pro

מק"ט: Find Place

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

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

מק"ט: Places – חיפוש בסביבה

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

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

מק"ט: מקומות - חיפוש טקסט

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

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

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

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

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

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

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

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

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

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

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

מכסות שימוש

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

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

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

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

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

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

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

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

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

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

אם באפליקציות שלכם יש נפח קריאות חודשי של 100,001 עד 500,000 או יותר, או אם המשתמשים שולחים יותר מ-12 בקשות להשלמה אוטומטית בכל סשן, Google ממליצה להשתמש בסשנים עם 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.

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

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