מקומות שימוש וחיוב ב-API

מידע על מסכות שדות

בשביל 'פרטי מקום' (חדש), 'חיפוש בקרבת מקום' (חדש) ו'חיפוש טקסט' (חדש), משתמשים בכותרת FieldMask בבקשות ה-API כדי לציין את רשימת השדות שיוחזר בתגובה. לאחר מכן, תחויבו לפי המק"ט הגבוה ביותר שרלוונטי לבקשה שלכם. כלומר, אם בוחרים שדות גם במק"ט של Essentials וגם במק"ט של Pro, החיוב מתבצע על סמך המק"ט של Pro.

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

מידע על סשנים של השלמה אוטומטית (חדשים)

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

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

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

אסימון סשן תקף לסשן אחד בלבד, ולא ניתן להשתמש בו ביותר מסשן אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב לא תקף והבקשות יחויבו כאילו לא סופק אסימון סשן.

פרטי מק"ט ותמחור של Places API

בטבלה הבאה מפורטים פרטי המק"ט והתמחור של Places API.

קטגוריהפרטי המק"ט של Places API (חדש)תמחור מק"טים
Essentials מק"ט: Autocomplete Requests רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials SKU: Autocomplete Session Usage רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: פרטי מקום בסיסי (מזהים בלבד) רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: Place Details Essentials רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: Text Search Essentials (מזהי פריטים בלבד) רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Nearby Search Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Place Details Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Text Search Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Nearby Search Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: חיפוש בקרבת מקום Enterprise Plus רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Place Details Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Text Search Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Text Search Enterprise + Atmosphere רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Place Details Photos רשימת התמחור הראשית
רשימת התמחור בהודו
קטגוריהפרטי המק"ט של Places API (קודם)תמחור מק"טים
Essentials מק"ט: השלמה אוטומטית – לכל בקשה רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: השלמה אוטומטית (כולל פרטי מקום) – לכל סשן רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: נתונים בסיסיים רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials SKU: Find Place - ID only רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: Place Details Essentials- ID Refresh רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Find Place רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: מקומות – חיפוש בסביבה רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Places - Text Search רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Place Details Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Atmosphere Data רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: פרטים ליצירת קשר רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Place Photos רשימת התמחור הראשית
רשימת התמחור בהודו

מגבלות שימוש אחרות

במאמר מכסות והתראות לגבי מכסות מוסבר איך לבדוק ולנהל את המכסות ואת מגבלות השימוש.

  • Places API (חדש): מגבלת הקצב בדקה היא לכל שיטת API לכל פרויקט. כלומר, לכל method של API יש מכסה נפרדת.

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

הגבלות בנוגע לתנאים ולהגבלות

למידע על תנאי השימוש, ראו המדיניות של Places API והקטע 'הגבלות רישיון' בתנאים ובהגבלות של הפלטפורמה של מפות Google.