Google ממליצה להשתמש בסשנים עם השלמה אוטומטית (חדשה). הסשנים עוזרים לפשט את התמחור ומספקים מודל תמחור עקבי לשימוש עם ההשלמה האוטומטית (חדש).
הסשן מתחיל בבקשה הראשונה של השלמה אוטומטית (חדשה) שכוללת טוקן לסשן, ממשיך בכל בקשה עוקבת של השלמה אוטומטית (חדשה), ומסתיים בבקשה של Place Details (חדש) או Address Validation שמשתמשת בטוקן לסשן.
אחרי שהסשן מסתיים, כל קריאה ל-Autocomplete (New), ל-Place Details (New) או ל-Address Validation שמשתמשת בטוקן לסשן שפג תוקפו מחויבת כאילו לא היה טוקן לסשן.
סשנים לא שלמים, כלומר סשנים שלא מסתיימים בבקשה ל-Place Details (חדש) או ל-Address Validation, מחויבים רק על הבקשות להשלמה אוטומטית (חדשה) באמצעות מק"ט: בקשות להשלמה אוטומטית.
חיוב לפי סשן
סשנים שמסתיימים בבקשה מסוג Place Details (New) Essentials
בסשנים של Autocomplete (חדש) שמסתיימים בבקשה שכוללת שדות מהמק"ט Places API Place Details Essentials:
- 12 הבקשות הראשונות להשלמה אוטומטית (חדש): החיוב מתבצע על כל בקשה להשלמה אוטומטית (חדש), עד למקסימום של 12 בקשות, באמצעות מק"ט: בקשות להשלמה אוטומטית.
- לבקשות 13 ואילך של השלמה אוטומטית (חדש) באותו סשן: החיוב מתבצע לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
- Place Details (New) Essentials: תחויבו גם על הבקשה שמסיימת את ההפעלה לפי מק"ט: Places API Place Details Essentials.
סשנים שמסתיימים בבקשות של Address Validation או Place Details (New) (לא Essentials)
בסשנים של השלמה אוטומטית (חדש) שמסתיימים בבקשה ל-Address Validation או בבקשה ל-Place Details (חדש) באמצעות שדות מ-Place Details ברמת Pro, Enterprise או Enterprise + Atmosphere:
- בקשות של השלמה אוטומטית (חדש): כל הבקשות של השלמה אוטומטית (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
-
בקשה ל-Place Details (New) או ל-Address Validation: תחויבו גם על הבקשה שמסיימת את הסשן, לפי המק"ט המתאים:
- בקשות שמסתיימות ב-Place Details (New) מחויבות לפי מק"ט: Place Details Enterprise + Atmosphere, בלי קשר לשדות שביקשתם.
- בקשות מסיימות של Address Validation מחויבות לפי מק"ט: Address Validation Enterprise.
תרחישים של תמחור סשנים
שלושת התרחישים הנפוצים ביותר לתמחור סשנים הם:
בקטעים הבאים מתוארים החיובים הנפרדים בכל תרחיש.
השלמה אוטומטית של נתוני מיקום
בתרחיש של השלמה אוטומטית של נתוני מיקום, אתם רוצים להשתמש ב-Autocomplete (חדש) וב-Place Details (חדש) כדי לקבל נתוני מיקום של מקום מסוים. לדוגמה, אתם בוחרים הצעה מההשלמה האוטומטית (חדש), ואז משתמשים ב-Place Details (חדש) כדי לקבל את הקואורדינטות של קו הרוחב וקו האורך של המקום ולהציג אותו במפה.
נתוני המיקום יכולים לכלול את הפרטים הבאים:
- כתובת
- מיקום כקואורדינטות של קווי רוחב ואורך
- Plus Code
- סוגים
- אזור התצוגה
הסשן הזה מסתיים בבקשה אחת ל-Place Details (New) שמבקשת שדות שמוגדרים על ידי SKU: Place Details Essentials.
החיוב מתבצע באופן הבא:
- על 12 הבקשות הראשונות להשלמה אוטומטית (חדש) תחויבו לפי מק"ט: בקשות להשלמה אוטומטית.
- כל בקשות ההשלמה האוטומטית (חדש) שנותרו מחויבות לפי מק"ט: שימוש בסשן השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
- בקשת הסיום של Place Details (New) מחויבת לפי SKU: Places API Place Details Essentials.
השלמה אוטומטית לחיפוש מקומות
בתרחיש של השלמה אוטומטית לחיפוש מקומות, אתם רוצים לקבל יותר מסתם נתוני מיקום של מקום מסוים. לדוגמה, אתם יכולים לבקש:
- אפשרויות נגישות
- שעות הפתיחה הנוכחיות
- אפשרויות החניה
- ביקורות
- דירוגים
בתרחיש הזה, הסשן מסתיים בקריאה אחת ל-Place Details (New) שמבקשת שדות כלשהם שנכללים במק"טים של Place Details (New) ברמת Pro, Enterprise או Enterprise + Atmosphere.
החיוב מתבצע באופן הבא:
- כל הבקשות להשלמה אוטומטית (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
- הבקשה הסופית של פרטי מקום (חדש) מחויבת לפי מק"ט: Places API Place Details Enterprise + Atmosphere.
השלמה אוטומטית של פרטי תשלום ומשלוח
Address Validation API הוא שירות שמקבל כתובת. הוא מזהה את רכיבי הכתובת ומאמת אותם. הוא גם יוצר פורמט סטנדרטי של הכתובת למשלוח דואר ומוצא את הקואורדינטות הכי מדויקות של קווי האורך והרוחב שלה.
בתרחיש של השלמה אוטומטית לתשלום ולמשלוח, אתם מסיימים את הסשן באמצעות בקשה ל-Address Validation API כדי לאמת את הכתובת שנבחרה.
החיוב מתבצע באופן הבא:
- כל הבקשות להשלמה אוטומטית (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
- בקשה אופציונלית של Place Details Essentials לא מחויבת בתשלום, אם היא נשלחת לפני בקשת הסיום של Address Validation.
- בקשת סיום האימות מחויבת לפי מק"ט: Address Validation Enterprise.
תמחור ללא סשנים
אם אתם לא משתמשים בסשנים, אתם מחויבים על כל בקשה להשלמה אוטומטית (חדש) באמצעות מק"ט: בקשות להשלמה אוטומטית.
תמחור של סשנים חלקיים או נטושים
אם סשן ננטש, כלומר לא מסתיים בקריאה ל-Place Details (New) או ל-Address Validation, הבקשות של ההשלמה האוטומטית (חדש) חוזרות למודל התמחור לכל בקשה ומחויבות לפי מק"ט: בקשות של השלמה אוטומטית.