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

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

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

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

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

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

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

• השלמה אוטומטית של נתוני מיקום
• השלמה אוטומטית לצורך גילוי מקומות
• השלמה אוטומטית בתהליך התשלום ובבחירת אופן המשלוח

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

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

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

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

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

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

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

• כל בקשה של השלמה אוטומטית (חדשה), עד 12 בקשות לכל היותר, באמצעות SKU: Autocomplete Requests.
• חיוב בסך 2.83 $לכל 1,000 בקשות, עד 100,000 בקשות
• חיוב בסך 2.27 $‎ לכל 1,000 בקשות, עד 500,000 בקשות
• בקשות להשלמה אוטומטית (חדשות) מס' 13 ואילך שנשלחות במהלך סשן פעיל מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
• בקשה אחת לקבלת פרטי מקומות באמצעות מק"ט: פרטי מקום (מיקום בלבד):
• חיוב בסך 5.00 $‎ לכל 1,000 בקשות, עד 100,000 בקשות
• חיוב בסך 4 $לכל 1,000 בקשות, עד 500,000 בקשות
הערה: אם שולחים בקשה לקבלת פרטי מקום באמצעות מק"ט: פרטי מקום (מיקום בלבד), ולאחר מכן שולחים בקשה לאימות כתובת לפני שתוקף אסימון הסשן יפוג (באותו הסדר), לא תחויבו על הבקשה באמצעות מק"ט: פרטי מקום (מיקום בלבד). הבקשה לאימות כתובת מחויבת באמצעות המק"ט SKU: Address Validation Preferred.

הערה: אם מסיימים את הסשן על ידי שליחת בקשה לפרטים של מקום (חדש) באמצעות SKU: Place Details (IDs Only), כל הבקשות להשלמה אוטומטית (חדש) יחויבו באמצעות SKU: Autocomplete Requests, כאילו לא השתמשתם בסשנים. הסיבה לכך היא שלא חל חיוב על הבקשה עם SKU: פרטי מקום (מזהים בלבד), ולכן כל הבקשות מסוג 'השלמה אוטומטית (חדש)' חוזרות לתמחור לפי בקשה.

השלמה אוטומטית לצורך גילוי מקומות

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

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

בתרחיש הזה, הסשן מסתיים על ידי בקשה לפרטים של מקום (חדש) שמבקשת כל שדה שכלול ב-SKU בסיסי, מתקדם או מועדף של פרטי המקום (חדש).

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

• כל הבקשות מסוג Autocomplete (חדש) מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
• בקשה אחת מסוג SKU: פרטי מקום (מועדף):
• חיוב בסך 25 $לכל 1,000 בקשות, עד 100,000 בקשות
• חיוב בסך 80 ש"ח לכל 1,000 בקשות, עד 500,000 בקשות

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

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

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

• כל הבקשות מסוג Autocomplete (חדש) מחוייבות לפי המק"ט SKU: Autocomplete Session Usage, כלומר אין חיוב על הבקשות האלה.
• בקשה אחת עם הערך SKU: Address Validation Preferred:
• חיוב בסך 25 $לכל 1,000 בקשות, עד 100,000 בקשות
• חיוב בסך 80 ש"ח לכל 1,000 בקשות, עד 500,000 בקשות

דוגמאות לתמחור

בטבלה הבאה מוצגות דוגמאות לתמחור של שלושת התרחישים העיקריים של סשנים. בטבלה הזו מפורטים גם המק"טים שמופיעים בדף החיוב לכל תרחיש.

תרחיש	דוגמה לבקשה	מק"טים שחויבו	מחיר לאלף בקשות
נתוני מיקום	5 בקשות להשלמה אוטומטית (חדש) בקשה אחת לפרטי מקום (חדש) באמצעות מק"ט: פרטי מקום (מיקום בלבד)	מק"ט: Autocomplete Requests מק"ט: פרטי מקום (מיקום בלבד)	5 בקשות להשלמה אוטומטית (חדש) – חיוב בסך 2.83$ (עד 12 בקשות לסשן) בקשה אחת לפרטים על מקום (חדש) שחויבה בסך 5$
גילוי מקומות	5 בקשות להשלמה אוטומטית (חדש) בקשה אחת לפרטי מקום (חדש) באמצעות אחת מהאפשרויות הבאות: מק"ט: פרטי מקום (בסיסי) מק"ט: פרטי מקום (מתקדם) מק"ט: פרטי המקום (מועדף)	SKU: Autocomplete Session Usage מק"ט: פרטי המקום (מועדף)	5 בקשות להשלמה אוטומטית (חדש) שחויבו ב-0$ בקשה אחת לפרטים של מקום (חדש) בחיוב של 25$
תשלום ומשלוח	5 בקשות להשלמה אוטומטית (חדש) בקשה אחת ל-Address Validation	SKU: Autocomplete Session Usage מק"ט: Address Validation Preferred	5 בקשות להשלמה אוטומטית (חדש) שחויבו ב-0$ בקשה אחת לאימות כתובת מועדף, ב-25$

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

אם לא משתמשים בסשנים, החיוב מתבצע לפי בקשה להשלמה אוטומטית (חדשה) באמצעות המק"ט Autocomplete Requests (בקשות להשלמה אוטומטית) בסכום של 2.83 $לכל 1,000 בקשות.

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

אם סשן מסוים לא הושלם, כלומר לא הסתיים בקריאה ל'פרטי המקום' (חדש) או ל'אימות כתובת', הבקשות להשלמה אוטומטית (חדש) חוזרות למודל התמחור לפי בקשה, והחיוב עליהן הוא 2.83$ לכל 1,000 בקשות, כפי שמוגדר ב-SKU: Autocomplete Requests.