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

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

כדי להשתמש בתכונה הזו, צריך להפעיל את Places API (חדש), הדור הבא של Places API. מידע נוסף מופיע במאמר הפעלת ממשקי API.

‫Google ממליצה להשתמש בסשנים עם השלמה אוטומטית (חדשה). הסשנים עוזרים לפשט את התמחור ומספקים מודל תמחור עקבי לשימוש עם השלמה אוטומטית (חדשה).

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

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

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

חיוב לפי סשן

סשנים שמסתיימים בבקשת Place Details (New) Essentials

בסשנים של השלמה אוטומטית (חדש) שמסתיימים בבקשה באמצעות שדות מתוך מק"ט: Places API Place Details Essentials:

• 12 הבקשות הראשונות להשלמה אוטומטית (חדש): אתם מחויבים על כל בקשה להשלמה אוטומטית (חדש), עד למקסימום של 12 בקשות, באמצעות מק"ט: בקשות להשלמה אוטומטית.
• לבקשות להשלמה אוטומטית (חדש) מספר 13 ומעלה באותו סשן: החיוב מתבצע לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
• פרטי מקום (חדש) – Essentials: אתם מחויבים גם על הבקשה שמסיימת את ההפעלה, לפי מק"ט: Places API Place Details Essentials.

הערה: אם מסיימים את הסשן על ידי שליחת בקשה אל Place Details (חדש) באמצעות מק"ט: Places API Place Details Essentials (מזהים בלבד), כל הבקשות אל Autocomplete (חדש) מחויבות באמצעות מק"ט: בקשות השלמה אוטומטית, כאילו לא השתמשתם בסשנים. הסיבה לכך היא שהבקשה שמשתמשת ב-SKU: Places API Place Details Essentials (IDs Only) לא מחויבת, ולכן כל הבקשות של ההשלמה האוטומטית (חדש) חוזרות לתמחור לכל בקשה.

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

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

• בקשות של השלמה אוטומטית (חדש): כל הבקשות של השלמה אוטומטית (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
• בקשה מסוג Place Details (New) או Address Validation: תחויבו גם על הבקשה שמסיימת את הסשן, לפי המק"ט המתאים:
  • בקשות שמופסקות ב-Place Details (New) מחויבות לפי SKU: Place Details Enterprise + Atmosphere, ללא קשר לשדות המבוקשים.
  • חיוב על בקשות לסיום אימות כתובות מתבצע לפי מק"ט: אימות כתובות – מהדורה לארגונים.

תרחישים של תמחור לפי סשן

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

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

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

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

בתרחיש של השלמה אוטומטית של נתוני מיקום, אתם רוצים להשתמש ב-Autocomplete (חדש) וב-Place Details (חדש) כדי לקבל נתוני מיקום של מקום מסוים. לדוגמה, אתם בוחרים הצעה מ-Autocomplete (חדש), ואז משתמשים ב-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.

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

• כל הבקשות לחיפוש אוטומטי (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
• החיוב על בקשת Place Details (New) שמסתיימת הוא לפי מק"ט: Places API Place Details Enterprise + Atmosphere.

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

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

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

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

• כל הבקשות של ההשלמה האוטומטית (חדש) מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית, כלומר אין חיוב על הבקשות האלה.
• בקשת Place Details Essentials אופציונלית לא כרוכה בתשלום, אם היא נשלחת לפני בקשת Address Validation שמסיימת את התהליך.
• בקשת הסיום של Address Validation מחויבת לפי מק"ט: Address Validation Enterprise.

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

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

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

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