דף זה תורגם על ידי Cloud Translation API.

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

ב-Places API (חדש) וב-Places API נעשה שימוש במודל תמחור של תשלום לפי שימוש. בקשות של Places API (חדש) ושל Places API יוצרות קריאות לכל אחד ממספר מק"טים. בנוסף לתנאים ולהגבלות הכלליים של Google, יש מגבלות שימוש ספציפיות ל-Places API. ניהול העלויות והשימוש באמצעות הכלים הזמינים במסוף Google Cloud.

אופן החיוב של Places API

Places API (חדש) ו-Places API משתמשים במודל תמחור של תשלום לפי שימוש. החיוב על ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google מתבצע באמצעות מק"טים. מתבצע מעקב אחר השימוש בכל מק"ט, וכל API או SDK יכולים לכלול יותר ממק"ט מוצר אחד. העלות מחושבת לפי:

שימוש במק"ט x מחיר לשימוש

תוכלו להשתמש במחשבון התמחור והשימוש כדי להעריך את עלות השימוש לכל API או SDK. לכל מק"ט שעומד בדרישות בפלטפורמה של מפות Google, זמין קרדיט של 200$ בפלטפורמה של מפות Google בכל חודש לכל חשבון לחיוב. הזיכוי יחול באופן אוטומטי על המק"טים שעומדים בדרישות.

תמחור של Places API (חדש)

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

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

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

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

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

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

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

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

מק"ט: בקשות להשלמה אוטומטית

Autocomplete Requests (בקשות להשלמה אוטומטית) – מק"ט לחיוב על כל בקשה ל-Autocomplete API (חדש) שלא כוללת אסימון סשן.

החיוב מתבצע גם אם אתם משתמשים באסימוני סשן, ובמקרים הבאים:

כדי לסיים את הסשנים, שולחים בקשה אחת ל-Place Details (New) שבה מבקשים את כל השדות שמוגדרים על ידי SKU: Place Details (Location Only).
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
לא תחויב, והסשן יחויב בהתאם ל-SKU: complete Session Usage (שימוש בהשלמה אוטומטית בסשן).

כדי לסיים את הסשן או לבטל אותו, צריך לבצע קריאה ל-SKU: Place Details (IDs Only). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות SKU: Inventory requests.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב ל-1,000)	0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: שימוש בסשן של השלמה אוטומטית

מק"ט של Autocomplete Session Usage מחויב על כל בקשה ל-Autocomplete API (חדש) שכוללת אסימון סשן.

המק"ט הזה מחויב בתרחישים הבאים:

סשן השלמה אוטומטית הסתיים בעקבות קריאה למק"ט: פרטי מקום (מיקום בלבד):
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Place Details (Basic, Advanced, or Preferred).

קריאה ל'פרטי מקום' שמבקשת כל שדה מהמק"ט: פרטי המקום (בסיסי, מתקדם או מועדף) מחויבת במק"ט: פרטי מקום (מועדף).
סשן השלמה אוטומטית הסתיים בקריאה ל-SKU: Address Validation Preferred.

הערה: אם מבצעים קריאה ל-SKU: Place Details (Location Only) ואז קריאה ל-SKU: Address Validation Preferred לפני שתוקף אסימון הסשן פג, לא תחויבו על הקריאה ל-SKU: Place Details (Location Only) והסשן שלכם יחויב רק על הקריאה ל-SKU: Address Validation Preferred.

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

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00 USD לכל (0.00 USD ל-1,000)	0.00 USD לכל (0.00 USD ל-1,000)	0.00 USD לכל (0.00 USD ל-1,000)

SKU: פרטי מקום (מזהים בלבד)

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

שירות אינטרנט: attributions, id, name^*, photos

^* השדה name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-displayName כדי לגשת לשם הטקסט של המקום.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000)	0.00 USD לכל (0.00 USD ל-1,000)	0.00 USD לכל (0.00 USD ל-1,000)

מק"ט: פרטי מקום (מיקום בלבד)

שירות אינטרנט: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.005$ לכל (5.00$ לכל 1,000)	0.004 USD לכל (4.00 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: פרטי המקום (בסיסי)

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

שירות אינטרנט: accessibilityOptions, businessStatus, containingPlaces, displayName, googleMapsLinks^*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations utcOffsetMinutes

, ^{googleMapsLinks}

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

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.0170 USD לכל (17.00 USD ל-1,000)	0.0136 USD לכל (13.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: פרטי מקום (מתקדם)

שירות אינטרנט: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, priceRange, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

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

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.020 USD לכל (20.00 USD ל-1,000)	0.016 USD לכל (16.00 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: פרטי המקום (מועדף)

allowsDogscurbsidePickupdeliverydineIneditorialSummaryevChargeOptionsfuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsroutingSummaries^*servesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.025 USD לכל (25.00 USD ל-1,000)	0.020 USD לכל (20.00 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: חיפוש בקרבת מקום (בסיסי)

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

שירות אינטרנט: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.attributions, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks^*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name^**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

^* השדה places.googleMapsLinks נמצא בשלב תצוגה מקדימה לפני GA, והוא לא כרוך בתשלום, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.

^** השדה places.name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000)	0.0256 USD לכל (25.60 USD ל-1,000)	לתמחור נפחי אחסון, פנו למחלקת המכירות

מק"ט: חיפוש בקרבת מקום (מתקדם)

שירות אינטרנט: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.035$ לכל (35.00$ ל-1,000)	0.028$ לכל (28.00$ ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: חיפוש בקרבת מקום (מועדף)

שירות אינטרנט: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,^* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

^* חיפוש טקסט וחיפוש בקרבת מקום בלבד

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.040 דולר ארה"ב לכל (40.00 דולר ארה"ב ל-1,000)	0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

SKU: Text Search (מזהה בלבד)

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

שירות אינטרנט: places.attributions, places.id, places.name^*, nextPageToken

^* השדה places.name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.0 דולר ארה"ב לכל (0.00 דולר ארה"ב לכל 1,000)	0.00 USD לכל (0.00 USD ל-1,000)	0.00 USD לכל (0.00 USD ל-1,000)

מק"ט: חיפוש טקסט (בסיסי)

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

שירות אינטרנט: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks^*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

^* השדה places.googleMapsLinks נמצא בשלב תצוגה מקדימה לפני GA, והוא ללא חיוב, כלומר החיוב הוא 0$ על שימוש במהלך התצוגה המקדימה.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000)	0.0256 USD לכל (25.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

SKU: חיפוש טקסט (מתקדם)

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.035$ לכל (35.00$ ל-1,000)	0.028 דולר ארה"ב לכל (28.00 דולר ארה"ב לכל 1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: חיפוש טקסט (מועדף)

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.040 דולר ארה"ב לכל (40.00 דולר ארה"ב ל-1,000)	0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב ל-1,000)	לתמחור נפחי אחסון, פנו למחלקת המכירות

מק"ט: Place Photo

המערכת מחייבת על כל בקשה ל-API במק"ט Place Photo.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.007 דולר ארה"ב לכל (7.00 דולר ארה"ב ל-1,000)	0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

התמחור של Places API

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

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

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

ניתן ליצור סשנים של השלמה אוטומטית מממשקי ה-API הבאים:

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

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

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

מידע על מק"טים של נתוני מקומות

שלושת המק"טים של נתוני המקומות הם: נתונים בסיסיים, פרטים ליצירת קשר ונתוני אטמוספרה.

מק"ט אחד או יותר של נתונים מופעל עבור:

Android: כל בקשה אל fetchPlace() או findCurrentPlace()
iOS: כל קריאה ל-fetchPlaceFromPlaceID: או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
שירות אינטרנט: כל בקשה של 'מקומות', בהתאם לשדות שצוינו בבקשה

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

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

פרטי המקומות
חיפוש מקום

בשירות האינטרנט, ממשקי ה-API האלה של מקומות קוראים אסור לציין את השדות שמוחזרים. הקריאות האלה תמיד מחזירות את כל נתוני Places, והחיוב הוא על שלושת המק"טים של נתוני Places, בנוסף לחיוב על כל בקשת API:

מקומות – חיפוש בקרבת מקום
מקומות – חיפוש טקסט

מק"ט: נתונים בסיסיים

באמצעות הפרמטר fields בבקשה לקבלת פרטי מקום או בבקשה לחיפוש מקום, אפשר להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה בסיסי כלולים בעלות הבסיסית של הבקשה ל-Places ולא גוררים חיוב נוסף. המק"ט Basic Data מופעל כשמתבצעת בקשה לאחד מהשדות הבאים:

Android: Place.Field.ACCESSIBILITY_OPTIONS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_MASK_URL, Place.Field.ID, Place.Field.LOCATION, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, או Place.Field.UTC_OFFSET.

הערה: השדות Place.Field.ADDRESS,‏ Place.Field.ICON_URL,‏ Place.Field.LAT_LNG,‏ Place.Field.NAME ו-Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אפשר להשתמש ב-Place.Field.FORMATTED_ADDRESS, ב-Place.Field.ICON_MASK_URL, ב-Place.Field.LOCATION, ב-Place.Field.DISPLAY_NAME וב-Place.ACCESSIBILITY_OPTIONS, בהתאמה. השדה Place.Field.ACCESSIBILITY_OPTIONS זמין רק לפרטי מקום (חדש).

iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes או GMSPlaceFieldViewport
שירות אינטרנט: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity, או wheelchair_accessible_entrance

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
עלות הבקשה להצגת העסק ב-Google + 0.00 USD	עלות הבקשה להצגת העסק ב-Google + 0.00 USD	עלות הבקשה להצגת העסק ב-Google + 0.00 USD

מק"ט: פרטי איש קשר

אפשר להגביל את התגובה רק לשדות שצוינו באמצעות הפרמטר fields בבקשה לפרטים של מקום או ל'חיפוש מקום' בשירותי אינטרנט, או באמצעות מערך של Place.Field ב-Android או ב-iOS. שדות בקטגוריה איש קשר יגרמו לחיוב נוסף. המק"ט פרטים ליצירת קשר מופעל כשמתבצעת בקשה לאחד מהשדות הבאים:

Android: Place.Field.CURRENT_OPENING_HOURS,‏Place.Field.INTERNATIONAL_PHONE_NUMBER,‏Place.Field.OPENING_HOURS,‏Place.Field.SECONDARY_OPENING_HOURS או Place.Field.WEBSITE_URI

הערה: השדה Place.Field.PHONE_NUMBER הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אתם צריכים להשתמש ב-Place.Field.INTERNATIONAL_PHONE_NUMBER.

iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber או GMSPlaceFieldWebsite
שירות אינטרנט: formatted_phone_number,‏international_phone_number,‏opening_hours,‏current_opening_hours,‏secondary_opening_hours או website

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
עלות של בקשת מקומות + 0.003 USD לכל (+ 3.00 USD לכל 1,000)	עלות הבקשה ל-Places + 0.0024 דולר ארה"ב לכל בקשה (+ 2.40 דולר ארה"ב ל-1,000 בקשות)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

Android: Place.Field.CURBSIDE_PICKUP,‏ Place.Field.DELIVERY,‏ Place.Field.EDITORIAL_SUMMARY,‏ Place.Field.DINE_IN,‏ Place.Field.PRICE_LEVEL,‏ Place.Field.RATING,‏ Place.Field.RESERVABLE,‏ Place.Field.SERVES_BEER,‏ Place.Field.SERVES_BREAKFAST,‏ Place.Field.SERVES_BRUNCH,‏ Place.Field.SERVES_DINNER,‏ Place.Field.SERVES_LUNCH,‏ Place.Field.SERVES_VEGETARIAN_FOOD,‏ Place.Field.SERVES_WINE,‏ Place.Field.TAKEOUT או Place.Field.USER_RATING_COUNT‏
‏
‏ הערה: השדה Place.Field.USER_RATINGS_TOTAL הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אתם צריכים להשתמש ב-Place.Field.USER_RATING_COUNT.
iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch או GMSPlaceFieldServesVegetarianFood.
JavaScript: מידע נוסף זמין בקטע שדות (פרטי המקום)
שירות אינטרנט: curbside_pickup,‏ delivery,‏ dine_in,‏ editorial_summary,‏ price_level,‏ rating,‏ reservable,‏ reviews,‏ serves_beer,‏ serves_breakfast,‏ serves_brunch,‏ serves_dinner,‏ serves_lunch,‏ serves_vegetarian_food,‏ serves_wine,‏ takeout או user_ratings_total.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
עלות הבקשה להוספת מקום + 0.005$‎ לכל בקשה (+ 5.00$‎ ל-1,000 בקשות)	עלות הבקשה ל-Places + 0.004$ לכל בקשה (+ 4.00$ ל-1,000 בקשות)	לתמחור נפחי אחסון, פנו למחלקת המכירות

SKU: השלמה אוטומטית – לפי בקשה

המק"ט Autocomplete – Per Request מחויב על כל אחת מהקריאות או הבקשות האלה שלא כוללות אסימון סשן:

Android: findAutocompletePredictions()
iOS: findAutocompletePredictionsFromQuery:
JavaScript: השירות של השלמה אוטומטית של מקומות ב-Maps JavaScript API
שירות אינטרנט: שירות ההשלמה האוטומטית של מקומות ב-Places API

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

בקשות להשלמה אוטומטית מהווידג'ט של השלמה אוטומטית במקום JavaScript של Maps API עשויות להיות כרוכות בתשלום השלמה אוטומטית – מק"ט לפי בקשה במקרה שקריאות מתבצעות מסשן לא חוקי של השלמה אוטומטית. מצב כזה יכול לקרות כשמשתמש מקלידים כמה כתובות שונות או מעתיקים/מדביקים כתובות שונות לווידג'ט, ולא תמיד בוחרים תחזית להשלמה אוטומטית.

טווח נפח חודשי (מחיר לבקשה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב ל-1,000)	0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן

המק"ט Autocomplete without Place Details – Per Session מחויב על סשן של השלמה אוטומטית שלא כולל בקשה לפרטים על מקום (במהלך כמה דקות מתחילת הסשן).

טווח נפח חודשי (מחיר לכל סשן)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.017 USD לכל (17.00 USD ל-1,000)	0.0136 USD לכל (13.60 USD ל-1,000)	לתמחור נפחי אחסון, פנו למחלקת המכירות

דוגמה

אם האפליקציה שלכם מבצעת את שתי הקריאות האלה בסשן אחד:

Android

findAutocompletePredictions() (‎.setQuery(”par”), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

שירות אינטרנט

בקשה להשלמה אוטומטית של מקום (input=”par”, session_token: XYZ)
בקשה להשלמה אוטומטית של מקום (input=”paris”, session_token: XYZ)

המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):

השלמה אוטומטית ללא פרטי מקום – לכל סשן (המחיר מתחיל ב-0.017$ לכל סשן)

SKU: השלמה אוטומטית (כלולה עם פרטי מקום) – לכל סשן

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

Android: שיחה אל fetchPlace()
iOS: קריאה ל-fetchPlaceFromPlaceID:
שירות אינטרנט: בקשה לקבלת פרטי מקום

הבקשה להשלמה האוטומטית זמינה ללא תשלום, והקריאה הבאה לקבלת פרטי המקום מחויבת לפי המחירון הרגיל של פרטי המקום.

בקשה לפרטים על מקום יוצרת מק"טים של נתונים (Basic,‏ Contact ו/או Atmosphere) בהתאם לשדות שצוינו בבקשה.

אם לא מציינים שדות בבקשה לפרטים על המקום, כל המק"טים של נתונים מופעלים (Basic,‏ Contact ו-Atmosphere).

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

טווח נפח חודשי (מחיר לכל סשן)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00 USD	0.00 USD	0.00 USD

דוגמה

אם האפליקציה שלכם מבצעת את שלוש הקריאות הבאות בסשן אחד:

Android

findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
fetchPlace() (עם FetchPlaceRequest שכולל את מזהה המקום ואת השדה ADDRESS)

iOS

placesClient?.findcompletePredictions(fromQuery: "par" ...
placesClient?.findcompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (כולל את מזהה המקום והשדה GMSPlaceFieldFormattedAddress)

שירות אינטרנט

בקשה להשלמה אוטומטית של מקומות (input=”par”, session_token: XYZ)
בקשה להשלמה אוטומטית של מקומות (input=”paris”, session_token: XYZ)
פרטי מקומות (place_id, session_token: XYZ, שדות:formatted_address)

המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):

השלמה אוטומטית (כלולה בפרטי המקום) – לכל סשן (החיוב מתבצע בסך 0.00 דולר ארה"ב)
פרטי מקום (מחיר החל מ- 0.017 USD לכל סשן)
נתונים בסיסיים (החיוב הוא 0.00$)

מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה

מק"ט של השלמה אוטומטית של שאילתות – לפי בקשה מחויב עבור כל בקשה:

JavaScript: שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API (getQueryPredictions()) והשימוש בווידג'ט SearchBox של Maps JavaScript API (בקשות להשלמה אוטומטית של שאילתות נוצרות בזמן שהמשתמש מקלידים).
שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות ב-Places API

טווח נפח חודשי (מחיר לכל בקשה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00283 דולר ארה"ב לכל (2.83 דולר ארה"ב ל-1,000)	0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000)	לתמחור נפחי אחסון, פנו למחלקת המכירות

אין תמיכה בתמחור לפי סשן של השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. החיוב על השיחות בקטע 'פרטי המקומות' ייקבע לפי התמחור הרגיל של פרטי המקומות.

מק"ט: פרטי המקום

החיוב על שיחות בפרטי מקום יתבצע באופן הבא:

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.017 USD לכל (17.00 USD ל-1,000)	0.0136 USD לכל (13.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

המק"ט פרטי המקום נוצר מהממשקי ה-API הבאים:

Android: Places SDK ל-Android (fetchPlace())
iOS: Places SDK ל-iOS (fetchPlaceFromPlaceID:)
JavaScript: שירות פרטי המקומות של Maps JavaScript API (getDetails)
JavaScript: הווידג'ט של השלמה אוטומטית של מקומות ב-Maps JavaScript API (getPlace)
JavaScript: הווידג'ט Place SearchBox של Maps JavaScript API: השיטה getPlaces() אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדיל), כפי שמוצג כאן:

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

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

קריאה או בקשה לפרטים של מקום יוצרות גם מק"טים של נתונים (Basic,‏ Contact ו/או Atmosphere), בהתאם לשדות שצוינו בקריאה או בבקשה. אם לא מציינים אף שדה בקריאה או בבקשה לקבלת פרטי המקום, מופעלים כל המק"טים של נתונים, ותחויבו על הקריאה או הבקשה לקבלת פרטי המקום בתוספת העלות של כל הנתונים.

דוגמאות

מבצעים את אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים ל-fetchPlace() ב-Android או ל-fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה ADDRESS
- Web API או שירות: יוצרים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address)
בחשבון יופיעו המק"טים הבאים (כשמציגים את החשבון לפי מק"ט):
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
מבצעים אחת מהפעולות הבאות:
- נייד: קוראים ל-fetchPlace() ב-Android או ל-fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה PHONE_NUMBER
- שירות או ממשק API לאינטרנט: שולחים בקשה לקבלת פרטי מקום ומציינים את השדה של מספר הטלפון: getPlaceDetails(fields: formatted_phone_number)
בחשבון יופיעו המק"טים הבאים (כשמציגים את החשבון לפי מק"ט):
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לכל בקשה)
מבצעים את אחת מהשיחות או הבקשות הבאות:
- נייד: קוראים למספר fetchPlace() ב-Android או למספר fetchPlaceFromPlaceID: ב-iOS ומציינים את כל השדות
- Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות): getPlaceDetails().
בחשבון יופיעו המק"טים הבאים (כשמציגים את החשבון לפי מק"ט):
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)

מק"ט: פרטי מקום – רענון מזהה

אפשר להשתמש בבקשה Place Details כדי לחדש מזהים של מקומות לא עדכניים. בקשות מהסוגים האלה זמינות ללא תשלום.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00 USD	0.00 USD	0.00 USD

דוגמה

שולחים בקשה לקבלת פרטי מקום ומציינים רק את השדה place id:‏ getPlaceDetails(fields: place_id). בחיוב יופיע המק"ט הזה (בצפייה בחיוב לפי מק"ט):

פרטי מקום – רענון תעודה מזהה (החיוב מתבצע בסך 0.00 דולר ארה"ב)

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

Find Place מחויב על בקשה לחיפוש מקום.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.017 USD לכל (17.00 USD ל-1,000)	0.0136 USD לכל (13.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

דוגמאות

שולחים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת: FindPlace(fields: formatted_address). המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
שולחים בקשה לחיפוש מקום ומציינים את השדה של מספר הטלפון: FindPlace(fields: formatted_phone_number). המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
שולחים בקשה לחיפוש מקום ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים: FindPlace(fields: formatted_address, opening_hours, price_level). בחשבון יופיעו המק"טים האלה (כשמציגים את החשבון לפי מק"ט):
- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב מתבצע בסך 0.00 USD)
- נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)

מק"ט: חיפוש מקום – מזהה בלבד

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

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	יותר מ-500,000
0.00 USD	0.00 USD	0.00 USD

דוגמה

שולחים בקשה לחיפוש מקום ומציינים רק את השדה place_id: FindPlace(fields: place_id). בחיוב יופיע המק"ט הזה (בצפייה בחיוב לפי מק"ט):

חיפוש מקום – תעודה מזהה בלבד (החיוב מתבצע בסך 0.00 דולר ארה"ב)

מק"ט: מקום – חיפוש בקרבת מקום

החיוב Place – חיפוש בקרבת מקום חויב עבור בקשות ל שירות החיפוש בקרבת מקום של Maps JavaScript API (nearbySearch()), או לשירות Places API Nearby Search

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000)	0.0256 דולר ארה"ב לכל (25.60 דולר ארה"ב לכל 1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

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

דוגמה

אתם שולחים בקשה לחיפוש בקרבת מקום, כמו NearbySearch (San Francisco, 100 meters). המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):

מקום – חיפוש בקרבת מקום (המחיר מתחיל ב-0.032$ לשיחה)
נתונים בסיסיים (החיוב הוא 0.00$)
נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)

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

החיוב על Place – Text Search מתייחס לבקשות לשירות החיפוש של מקומות בטקסט ב-Maps JavaScript API (textSearch()) או לשירות החיפוש בטקסט של Places API.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב לכל 1,000)	0.0256 USD לכל (25.60 USD ל-1,000)	פנייה למחלקת המכירות לקבלת מחיר נפח

בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא תומכות בקביעה של השדות שיוחזרו. בקשות מסוג חיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשת חיפוש טקסט החל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (Basic Data,‏ Contact Data ו-Atmosphere Data).

המק"ט 'מקום – חיפוש טקסט' נוצר גם באמצעות הווידג'ט של תיבת החיפוש של מקום ב-API של מפות Google: getPlaces() אחרי שהמשתמש בוחר שאילתת מקום (סמל: זכוכית מגדלת), לא תוצאה (סמל: סיכה), כפי שמוצג כאן:

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

דוגמה

יוצרים בקשה של חיפוש טקסט, למשל TextSearch(123 Main Street). בחיוב יופיעו המק"טים הבאים (בצפייה בחיוב לפי מק"ט):

מקום – חיפוש טקסט (המחיר מתחיל ב-0.032$ לשיחה)
נתונים בסיסיים (החיוב הוא 0.00$)
נתונים ליצירת קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)

מק"ט: Place Photo

מק"ט של תמונה של מקום מחויב על:

Android: שיחות אל fetchPhoto()
iOS: שיחות למספר loadPlacePhoto:
JavaScript: לספריית המקומות, השירות של Place Photos בממשק API של JavaScript במפות Google כשמבקשים נתונים מכתובות ה-URL שמוחזרות על ידי PlacePhoto.getUrl() כדי לטעון נתוני פיקסלים של תמונות
שירות אינטרנט: בקשות לשירות התמונות של Places API

בשירות JavaScript, הקריאה ל-method‏ PlacePhoto.getUrl() לא גורמת לחיוב עד שמשתמשים בכתובת ה-URL בפועל כדי לקבל נתוני פיקסלים.

טווח נפח חודשי (מחיר לשיחה)
0 עד 100,000	100,001 עד 500,000	מעל 500,000
0.007 דולר ארה"ב לכל (7.00 דולר ארה"ב ל-1,000)	0.0056 דולר ארה"ב לכל (5.60 דולר ארה"ב ל-1,000)	לתמחור נפחי אחסון, פנו למחלקת המכירות

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

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

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

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

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

ניהול עלות השימוש

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

כדי להציג או לשנות את מגבלות המכסה של Places API:

במסוף Cloud, פותחים את הדף מכסות בפלטפורמה של מפות Google.
לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים ב-Places API.
כדי לראות את מגבלות המכסות, גוללים למטה לכרטיס Requests.
טבלה עם שמות המכסות והמגבלות שלהן.
כדי לשנות את מגבלת המכסה, לוחצים על סמל עריכה של המגבלה הרלוונטית.
בתיבת הדו-שיח שמופיעה, בשדה Quota Limit, מזינים את המגבלה היומית המועדפת לחיוב (עד למגבלת המכסה, אם יש כזו, שצוינה על ידי Google) ובוחרים באפשרות Save.

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

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

אופן החיוב של Places API

תמחור של Places API (חדש)

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

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

מק"ט: בקשות להשלמה אוטומטית

מק"ט: שימוש בסשן של השלמה אוטומטית

SKU: פרטי מקום (מזהים בלבד)

מק"ט: פרטי מקום (מיקום בלבד)

מק"ט: פרטי המקום (בסיסי)

מק"ט: פרטי מקום (מתקדם)

מק"ט: פרטי המקום (מועדף)

מק"ט: חיפוש בקרבת מקום (בסיסי)

מק"ט: חיפוש בקרבת מקום (מתקדם)

מק"ט: חיפוש בקרבת מקום (מועדף)

SKU: Text Search (מזהה בלבד)

מק"ט: חיפוש טקסט (בסיסי)

SKU: חיפוש טקסט (מתקדם)

מק"ט: חיפוש טקסט (מועדף)

מק"ט: Place Photo

התמחור של Places API

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

מידע על מק"טים של נתוני מקומות

מק"ט: נתונים בסיסיים

מק"ט: פרטי איש קשר

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

SKU: השלמה אוטומטית – לפי בקשה

מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן

דוגמה

Android

iOS

שירות אינטרנט

SKU: השלמה אוטומטית (כלולה עם פרטי מקום) – לכל סשן

דוגמה

Android

iOS

שירות אינטרנט

מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה

מק"ט: פרטי המקום

דוגמאות

מק"ט: פרטי מקום – רענון מזהה

דוגמה

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

דוגמאות

מק"ט: חיפוש מקום – מזהה בלבד

דוגמה

מק"ט: מקום – חיפוש בקרבת מקום

דוגמה

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

דוגמה

מק"ט: Place Photo

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

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

ניהול עלות השימוש

מקורות מידע קשורים בנושא ניהול עלויות