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

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

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

תמחור עבור Places API (חדש)

מידע על אנונימיזציה של שדות

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

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

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

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

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

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

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

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

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

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

  • מסיימים את הסשנים באמצעות בקשה אחת לפרטי המקום (חדש) שמבקשת מכם שדות כלשהם שהוגדרו ב-SKU: Place Details (Location בלבד).
    • כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות מק"ט: בקשות להשלמה אוטומטית.
    • החיוב על כל בקשה נוספת להשלמה אוטומטית (חדשה) מתבצע באמצעות מק"ט: שימוש בסשן בהשלמה אוטומטית.
  • אפשר לעזוב את הסשן או לסיים את הסשן על ידי ביצוע שיחה למק"ט: פרטי מקום (מזהים בלבד). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשה) יחויבו באמצעות מק"ט: בקשות להשלמה אוטומטית.
טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00283 USD לכל
(2.83 USD ל-1000)		 0.00227 USD לכל
(2.27 USD לכל 1000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

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

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

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

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

  • תכונת ההשלמה האוטומטית הסתיימה עם קריאה ל-SKU: פרטי מקום (בסיסי, מתקדם או מועדף) או באמצעות קריאה ל-SKU: Preferred Validation Preferred.

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

טווח נפח חודשי
(מחיר לשיחה)
0-100,000 100,001–500,000 יותר מ-500,000
0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)		 0.00 דולר ארה"ב לכל
(0.00 דולר ארה"ב לכל 1000)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שירות אינטרנט: allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, }restroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

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

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

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

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

שירות האינטרנט: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name*, places.photos, places.plusCode, places.primaryType, /places.nameplaces.primaryTypeDisplayNameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

places/PLACE_ID משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.

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

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

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

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

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

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

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

שירות אינטרנט: 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.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

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

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

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

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

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

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

שירות אינטרנט: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, , places.subDestinations, places.plusCodeplaces.typesplaces.utcOffsetMinutesplaces.viewport

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

מק"ט: Text Search (מתקדם)

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

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

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

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

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

שירות אינטרנט: 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.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

המערכת מחייבת את המק"ט של תמונת מקום על כל בקשה ל-API.

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

תמחור עבור Places API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET או Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • 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
עלות של בקשת מקומות
+ 0.00 USD		 עלות של בקשת מקומות
+ 0.00 USD		 עלות של בקשת מקומות
+ 0.00 USD

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

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

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, 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
עלות של בקשת מקומות
+ 0.003 USD לכל אחד
(+ 3.00 USD ל-1,000)		 העלות של בקשת מקומות
+ 0.0024 USD לכל אחד
(+ 2.40 USD ל-1,000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

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

  • 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_RATINGS_TOTAL
  • 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)		 עלות של בקשת מקומות
+ 0.004$ לכל אחד
(+ 4.00 USD ל-1,000)		 כדי לברר פרטים על תמחור לפי נפח אחסון אפשר לפנות למחלקת המכירות

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

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

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

ייתכן שתחויבו על ידי השלמה אוטומטית של בקשות מהווידג'ט להשלמה אוטומטית של מקומות מהווידג'ט להשלמה אוטומטית של מקומות במפות Google. במקרה של הפעלות לא חוקיות של השלמה אוטומטית, ייתכן שתחויבו בהשלמה אוטומטית לפי מק"ט. זה עשוי לקרות כאשר משתמש מקליד מספר כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט ולא תמיד בוחר בחיזוי של השלמה אוטומטית.

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

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

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

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

דוגמה

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

Android

iOS

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

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

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

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

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

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

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

בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, יצירת קשר ו/או אטמוספירה) – בהתאם לשדות שצוינו בבקשה.

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

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

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

דוגמה

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

Android

iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמאות

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

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

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

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

דוגמה

יוצרים בקשה לפרטי המקום כדי לציין רק את השדה של מזהה המקום: getPlaceDetails(fields: place_id). בדף החשבון, המק"ט יופיע ברשימה (כשמציגים את החיוב לפי מק"ט):

  • פרטי המקום – רענון מזהה (חיוב בסך 0.00 ש"ח)

מק"ט: Find Place

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

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

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

דוגמאות

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

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

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

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

מקום – חיפוש בקרבת מקום מחויב בגין בקשות אל שירות חיפוש בקרבת מקום של Maps JavaScript API (nearbySearch()), או אל שירות 'חיפוש בקרבת מקום' של Places API

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

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

דוגמה

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

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

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

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

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

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

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

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

דוגמה

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. על מנת לקבל את הקרדיט לפלטפורמה של מפות Google, המשתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני שהם יוצרים חשבון לחיוב בפלטפורמה של מפות Google.↩