השלמה אוטומטית (חדש) ותמחור סשן

בחירת פלטפורמה: Android iOS JavaScript Web Service

‫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:

סשנים שמסתיימים בבקשות של Address Validation או Place Details (New) (לא Essentials)

בסשנים של השלמה אוטומטית (חדש) שמסתיימים בבקשה ל-Address Validation או בבקשה ל-Place Details (חדש) באמצעות שדות מ-Place Details ברמת Pro,‏ Enterprise או Enterprise + Atmosphere:

תרחישים של תמחור סשנים

שלושת התרחישים הנפוצים ביותר לתמחור סשנים הם:

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

השלמה אוטומטית של נתוני מיקום

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

נתוני המיקום יכולים לכלול את הפרטים הבאים:

  • כתובת
  • מיקום כקואורדינטות של קווי רוחב ואורך
  • Plus Code
  • סוגים
  • אזור התצוגה

הסשן הזה מסתיים בבקשה אחת ל-Place Details (New) שמבקשת שדות שמוגדרים על ידי SKU: Place Details Essentials.

החיוב מתבצע באופן הבא:

תרשים חיוב של השלמה אוטומטית לתרחיש של נתוני מיקום

השלמה אוטומטית לחיפוש מקומות

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

  • אפשרויות נגישות
  • שעות הפתיחה הנוכחיות
  • אפשרויות החניה
  • ביקורות
  • דירוגים

בתרחיש הזה, הסשן מסתיים בקריאה אחת ל-Place Details (New) שמבקשת שדות כלשהם שנכללים במק"טים של Place Details (New) ברמת Pro,‏ Enterprise או Enterprise + Atmosphere.

החיוב מתבצע באופן הבא:

תרשים חיוב של השלמה אוטומטית לתרחיש של גילוי מקומות

השלמה אוטומטית של פרטי תשלום ומשלוח

‫Address Validation API הוא שירות שמקבל כתובת. הוא מזהה את רכיבי הכתובת ומאמת אותם. הוא גם יוצר פורמט סטנדרטי של הכתובת למשלוח דואר ומוצא את הקואורדינטות הכי מדויקות של קווי האורך והרוחב שלה.

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

החיוב מתבצע באופן הבא:

תרשים חיוב של השלמה אוטומטית בתרחיש של תשלום ומשלוח

תמחור ללא סשנים

אם אתם לא משתמשים בסשנים, אתם מחויבים על כל בקשה להשלמה אוטומטית (חדש) באמצעות מק"ט: בקשות להשלמה אוטומטית.

תמחור של סשנים חלקיים או נטושים

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