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

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

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

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

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

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

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

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

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

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

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

קטגוריהפרטי המק"ט של Places API (חדש)תמחור מק"טים
Essentials SKU: Autocomplete Requests רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials SKU: Autocomplete Session Usage רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: Place Details Essentials (מזהים בלבד) רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: Place Details Essentials רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: הנחיות בסיסיות להתאמת תוכן לחיפוש Google (מזהים בלבד) רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: חיפוש בסביבה Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: Place Details Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: חיפוש טקסט Pro רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש בסביבה Enterprise + Atmosphere רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: Place Details Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: Place Details Enterprise + Atmosphere רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש טקסט Enterprise רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: חיפוש טקסט Enterprise + Atmosphere רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: תמונות של פרטי מקום רשימת המחירים הראשית
רשימת המחירים בהודו
קטגוריהפרטי המק"ט של Places API (גרסה קודמת)תמחור מק"טים
Essentials מק"ט: השלמה אוטומטית – לכל בקשה רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials

SKU: Basic Data

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: חיפוש מקום - מזהה מקום בלבד רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials SKU: Place Details Essentials - ID Refresh רשימת המחירים הראשית
רשימת המחירים בהודו
Essentials מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה רשימת המחירים הראשית
רשימת המחירים בהודו
Pro מק"ט: השלמה אוטומטית ללא Place Details – לכל סשן רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: חיפוש מקום

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: מקומות – חיפוש בסביבה

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: מקומות – חיפוש טקסט

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Pro

מק"ט: פרטי מקומות

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise

מק"ט: נתוני אווירה

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise

מק"ט: נתוני אנשי קשר

חיובים נוספים:

רשימת המחירים הראשית
רשימת המחירים בהודו
Enterprise מק"ט: Place Photos רשימת המחירים הראשית
רשימת המחירים בהודו

מכסות שימוש

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

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

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

שינוי המכסה

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

כדי לשנות את ערך המכסה של ה-API, פועלים לפי השלבים הבאים:

  1. במסוף Cloud, עוברים אל Google Maps Platform > מכסות.
  2. בוחרים את ה-API שרוצים לשנות את המכסה שלו.
  3. מזהים את ערך המכסה שרוצים לשנות ומסמנים את התיבה שלידו.
  4. לוחצים על Edit (עריכה), מזינים ערך חדש למכסה ולוחצים על Submit request (שליחת הבקשה).

הצגה של בקשות להגדלת מכסות

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

  1. במסוף Cloud, עוברים אל Google Maps Platform > מכסות.
  2. בוחרים את ה-API שרוצים לראות את הבקשה להגדלת המכסה שלו.
  3. לוחצים על Increase Requests (הגדלת מספר הבקשות).

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

מידע על תנאי השימוש זמין במדיניות בנושא Places API ובקטע הגבלות על רישיון בתנאים ובהגבלות של Google Maps Platform.