מידע על מסכות שדות
בגרסאות החדשות של Place Details, חיפוש בסביבה וחיפוש טקסט, משתמשים בכותרת FieldMask בבקשות ל-API כדי לציין את רשימת השדות שיוחזרו בתגובה. לאחר מכן תחויבו במק"ט הגבוה ביותר שרלוונטי לבקשה שלכם. כלומר, אם תבחרו שדות גם במק"ט Essentials וגם במק"ט Pro, תחויבו לפי מק"ט Pro.
שימוש במסכת שדות הוא שיטה טובה לוודא שאתם לא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר ומחיובים מיותרים.
מידע על סשנים של 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 API
בטבלה הבאה מוצגים פרטי המק"טים של Places API בתשלום לפי שימוש והמחירים שלהם.
מכסות שימוש
במאמר מכסות והתראות על הגעה למכסה מוסבר איך בודקים ומנהלים את המכסות ומגבלות השימוש.
Places API (חדש): מגבלת הקצב לדקה היא לכל שיטת API בכל פרויקט. במילים אחרות, לכל שיטת API יש מכסה נפרדת.
Places API (מדור קודם): הגבלת קצב של יצירת בקשות לדקה מחושבת כסכום של הבקשות בצד הלקוח ובצד השרת בכל האפליקציות שמשתמשות בפרטי הכניסה של אותו פרויקט.
אסטרטגיות חסכוניות לשימוש ב-Places API
בקטע הזה מפורטות דרכים לאופטימיזציה של השימוש ולהפחתת העלויות שקשורות ל-Places API.
שימוש במסכות שדות
שימוש במסכת שדות מבטיח שלא תבקשו נתונים מיותרים, וכך עוזר לצמצם את זמן האחזור ואת החיובים.
בבקשות של פרטי מקום (חדש), חיפוש בסביבה (חדש) וחיפוש טקסט (חדש), צריך להשתמש במסכת שדות כדי לציין את רשימת השדות שיוחזרו בתגובה.
לאחר מכן, החיוב מתבצע לפי המק"ט הגבוה ביותר שרלוונטי לבקשה. לדוגמה, אם תבחרו שדות גם מהמק"ט Essentials וגם מהמק"ט Pro, תחויבו לפי המק"ט Pro.
שימוש בתמחור לפי סשן עם Place Details (New)
אם לאפליקציות שלכם יש נפח קריאות חודשי של
מידע נוסף זמין במאמר השלמה אוטומטית (חדשה) ותמחור לפי סשן.
שינוי המכסה
מגבלות המכסות מגדירות את המספר המקסימלי של בקשות שמותר לשלוח ל-API או לשירות מסוים בפרק זמן נתון. כשמספר הבקשות בפרויקט מגיע למגבלת המכסה, השירות מפסיק להגיב לבקשות.
כדי לשנות ערך של מכסה ב-API:
- במסוף Cloud, נכנסים לדף Google Maps Platform > Quotas.
- בוחרים את ה-API שרוצים לשנות את המכסה שלו.
- מזהים את ערך המכסה שרוצים לשנות ומסמנים את התיבה שלידו.
- לוחצים על Edit, מזינים ערך חדש למכסה ולוחצים על Submit request.
הצגה של בקשות להגדלת מכסות
כדי לראות את כל הבקשות להגדלת מכסות, כולל בקשות קודמות ובקשות בהמתנה, מבצעים את השלבים הבאים:
- במסוף Cloud, נכנסים לדף Google Maps Platform > Quotas.
- בוחרים את ה-API שרוצים לראות את הבקשה להגדלת המכסה שלו.
- לוחצים על Increase Requests.
הגבלות של התנאים וההגבלות
מידע נוסף על תנאי השימוש זמין במדיניות של Places API ובקטע "הגבלות על רישיונות" בתנאים ובהגבלות של Google Maps Platform.