מקומות שימוש וחיוב ב-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: Place Details (IDs Only). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות SKU: Autocomplete 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 (חדש) שכוללת אסימון סשן.

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

  • סשן ההשלמה האוטומטית הסתיים על ידי קריאה ל-SKU: Place Details (Location Only):

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

    קריאה ל-Place Details שמבקשת כל שדה מ-SKU: Place Details (Basic,‏ Advanced או Preferred) מחויבת לפי SKU: Place Details (Preferred).

  • סשן ההשלמה האוטומטית הסתיים בקריאה ל-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)

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

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

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

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

טווח נפח חודשי
(מחיר לשיחה)
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)

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

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

שירות אינטרנט: 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 נמצא בשלב תצוגה מקדימה לפני GA, והוא ללא חיוב, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.

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

טווח נפח חודשי
(מחיר לשיחה)
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

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

טווח נפח חודשי
(מחיר לשיחה)
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)
פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

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

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

טווח נפח חודשי
(מחיר לשיחה)
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)
פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: חיפוש טקסט (מזהה בלבד)

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

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

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

טווח נפח חודשי
(מחיר לשיחה)
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)

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

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

שירות אינטרנט: 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)
פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

שירות אינטרנט: 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)
פנייה למחלקת המכירות לקבלת מחיר נפח

מק"ט: 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 מתבצעת כשהמשתמש בוחר באחת מההצעות של ההשלמה האוטומטית. אם המשתמש לא בוחר הצעה, לא מתבצעת קריאה ל-Places Details.

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

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

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

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

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

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

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

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

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

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

בשירות האינטרנט, הקריאות האלה ל-Places APIs לא תומכות בתיוג של השדות שיוחזרו. הקריאות האלה תמיד מחזירות את כל נתוני 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.
  • 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
  • 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
עלות הבקשה ל-Places
+ 0.003$ לכל בקשה
(+ 3.00$ לכל 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
  • 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 בקשות)
פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

אם יתבצעו קריאות מסשן השלמה אוטומטית לא חוקי, יכול להיות שתחויבו על בקשות השלמה אוטומטית מ-ווידג'ט ההשלמה האוטומטית של מקומות ב-Maps JavaScript 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

iOS

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

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

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

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

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

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

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

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

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

בקשות לרענון מזהה של פרטי מקום (בקשות שמציינות רק את השדה place_id) במהלך סשן של השלמה אוטומטית מחוייבות כ-SKU: Autocomplete without Place Details – Per Session.

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

דוגמה

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

Android

iOS

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

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

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

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

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

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

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


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

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

טווח נפח חודשי
(מחיר לשיחה)
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)
פנייה למחלקת המכירות לקבלת מחיר נפח

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

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

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

דוגמאות

  1. מבצעים אחת מהפעולות הבאות:
    • נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה ADDRESS
    • API או שירות אינטרנט: שולחים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address)
    בחשבון יופיעו המק"טים הבאים (כשמציגים את החשבון לפי מק"ט):
    • פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
    • נתונים בסיסיים (החיוב הוא 0.00$)
  2. מבצעים אחת מהפעולות הבאות:
    • נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה PHONE_NUMBER
    • שירות או ממשק API לאינטרנט: שולחים בקשה לפרטים של מקום ומציינים את השדה של מספר הטלפון: getPlaceDetails(fields: formatted_phone_number)
    בחשבון יופיעו המק"טים הבאים (כשמציגים את החשבון לפי מק"ט):
    • פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
    • פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
  3. מבצעים אחת מהפעולות הבאות:
    • נייד: מחייגים למספר 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, מוחזרים רק מזהה המקום, כך שלא נצברים חיובים נוספים על נתונים.

דוגמאות

  1. שולחים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת: FindPlace(fields: formatted_address). המק"טים האלה יופיעו בחשבון (כש מציגים את החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
    • נתונים בסיסיים (החיוב הוא 0.00$)
  2. שולחים בקשה לחיפוש מקום ומציינים את השדה של מספר הטלפון: FindPlace(fields: formatted_phone_number). המק"טים האלה יופיעו בחשבון (כש מציגים את החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
    • פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
  3. שולחים בקשה לחיפוש מקום ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים: FindPlace(fields: formatted_address, opening_hours, price_level). בחשבון יופיעו המק"טים האלה (כש מציגים את החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
    • נתונים בסיסיים (החיוב הוא 0.00$)
    • פרטי איש קשר (המחיר מתחיל ב-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$)

ב-Places – חיפוש בקרבת מקום, החיוב מתבצע על בקשות ל שירות חיפוש מקומות בקרבת מקום של Maps JavaScript API (nearbySearch()), או ל שירות חיפוש בקרבת מקום של 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$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (נתונים בסיסיים, פרטים ליצירת קשר ונתוני אטמוספרה).

דוגמה

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

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

ב-Places – חיפוש טקסט תחויבו על בקשות ל שירות חיפוש הטקסט של מקומות ב-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).

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

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

דוגמה

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

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

מק"ט: תמונה של מקומות

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

בשירות 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:

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

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