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

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

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

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

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

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

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

אחרי שמשתמש בוחר מקום (כלומר, מתבצעת בקשה של Place Details (New) או בקשה של 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 מק"ט: Text Search Essentials (מזהים בלבד) רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Nearby Search Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Place Details Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Text Search Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Nearby Search Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: חיפוש בקרבת מקום Enterprise Plus רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: פרטי מקום Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: פרטי מקום Enterprise + Atmosphere רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Text Search Enterprise רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: Text Search Enterprise + Atmosphere רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: תמונות של פרטי מקום רשימת התמחור הראשית
רשימת התמחור בהודו
קטגוריהפרטי המק"ט של Places API (קודם)תמחור מק"טים
Essentials מק"ט: השלמה אוטומטית – לכל בקשה רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: השלמה אוטומטית (כלולה בפרטי מקום) – לכל סשן רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials SKU: Basic Data רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials SKU: Find Place - ID only רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials SKU: Place Details Essentials- ID Refresh רשימת התמחור הראשית
רשימת התמחור בהודו
Essentials מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: חיפוש מקום רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: מקומות – חיפוש בסביבה רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Places – חיפוש טקסט רשימת התמחור הראשית
רשימת התמחור בהודו
Pro מק"ט: Place Details Pro רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: נתוני Atmosphere רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise מק"ט: נתונים של אנשי קשר רשימת התמחור הראשית
רשימת התמחור בהודו
Enterprise SKU: Place Photos רשימת התמחור הראשית
רשימת התמחור בהודו

מגבלות שימוש

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

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

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

שינוי המכסה

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

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

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

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

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

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

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

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