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

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

חיוב ותמחור של Places API

למידע על האופן שבו Google מחשבת את החיוב והתמחור, אפשר לעיין במחירון של הפלטפורמה של מפות Google או במחירון של הפלטפורמה של מפות Google – הודו.

מק"טים של מוצרים ב-Places (חדש)

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

קטגוריה	האם המק"ט נכלל בקטגוריית המק"טים של Essentials,‏ Pro או Enterprise.
אירוע לחיוב	האירוע שמחויב על המק"ט.
טריגרים	אילו רכיבי קוד מפעילים אירועים לחיוב.
Pricing	קישורים לטבלת התמחור של הקבוצה של המק"ט הזה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מק"ט: Places API Place Details Essentials (IDs Only)

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שדות לשירות אינטרנט attributions id name^* photos ^* השדה name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-displayName כדי לגשת לשם הטקסט של המקום.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Essentials

המק"ט הזה מחויב על בקשות ל-Place Details API שמאחזרות את השדות שבמק"ט הזה.

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את שדות המיקום הבאים: שדות לשירות אינטרנט addressComponents adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Pro

המק"ט הזה מחויב על שדות שציינתם בבקשה ל-Place Details Pro.

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר: שדות לשירות אינטרנט accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks^* googleMapsUri iconBackgroundColor iconMaskBaseUri primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations utcOffsetMinutes ^* השדה googleMapsLinks נמצא בשלב של תצוגה מקדימה לפני GA, ואין חיוב, כלומר החיוב הוא 0 $על השימוש במהלך התצוגה המקדימה.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Enterprise

המק"ט הזה מחויב על בקשה של Places שכוללת שדות של Enterprise.

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שדות לשירות אינטרנט currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours userRatingCount websiteUri אם תסיימו סשן השלמה אוטומטית בקריאה ל-Place Details שמבקשת כל שדה מ-מק"ט: Place Details Essentials,‏ Pro,‏ Enterprise או Enterprise + Atmosphere, הקריאה תחויב לפי מק"ט: Place Details Enterprise + Atmosphere. למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Enterprise + Atmosphere

המק"ט הזה מחויב על קריאות ל-Place Details API שמבקשות את שדות האווירה שצוינו.

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שירות אינטרנט: 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 ^* חיפוש טקסט וחיפוש בקרבת מקום בלבד אם סשן של השלמה אוטומטית מסתיים על ידי קריאה ל-Place Details שמבקשת כל שדה מ-מק"ט: Place Details Essentials,‏ Pro,‏ Enterprise או Enterprise + Atmosphere, החיוב על הקריאה מתבצע לפי מק"ט: Place Details Enterprise + Atmosphere. למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
	דוגמאות לחיוב באמצעות מסכת שדה	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Nearby Search Pro

המק"ט הזה מחויב על שדות שציינתם בבקשה ל-חיפוש בקרבת מקום Pro.

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם תמחור נמוך יותר: שדות לשירות אינטרנט 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.postalAddress 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 כדי לגשת לשם הטקסט של המקום.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Nearby Search Enterprise

המק"ט הזה מחויב על בקשות לחיפוש עסקים בקרבת מקום שכוללות שדות של Enterprise.

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שדות לשירות אינטרנט places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Nearby Search Enterprise + Atmosphere

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שירות אינטרנט: 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 ^* חיפוש טקסט וחיפוש בקרבת מקום בלבד
	דוגמאות לחיוב באמצעות מסכת שדה	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Essentials (IDs Only)

המק"ט הזה מחויב על בקשות ל-Text Search API שמחזירות רק מזהי מסמכים.

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים: שדות לשירות אינטרנט places.attributions places.id places.name^* nextPageToken ^* השדה places.name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Pro

המק"ט הזה הוא מק"ט נתונים שמשמש לחיוב על שדות שציינתם בבקשה ל-Text Search Pro.

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר: שדות לשירות אינטרנט 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.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport ^* השדה places.googleMapsLinks נמצא בשלב של תצוגה מקדימה לפני GA, ואין חיוב, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Enterprise

המק"ט הזה מחויב על בקשות לחיפוש טקסט שכוללות שדות Enterprise.

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שדות לשירות אינטרנט places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Enterprise + Atmosphere

המק"ט הזה מחויב על בקשות לחיפוש טקסט שכוללות שדות של אטמוספרה.

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: שירות אינטרנט: 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 ^* חיפוש טקסט וחיפוש בקרבת מקום בלבד
	דוגמאות לחיוב באמצעות מסכת שדה	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Place Details Photos

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	החיוב מופעל כששולחים בקשה לתמונה מ-Place Details API.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"טים של מוצרים מדור קודם של Places

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

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

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

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

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

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

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

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

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

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

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

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

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

• Places Details Pro
• חיפוש מקום

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

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

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

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

שדות בקטגוריה בסיסי כלולים בעלויות הבסיסית של הבקשה ל-Places ולא גוררים חיוב נוסף.

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט Basic Data מופעל כשמבקשים את אחד מהשדות הבאים: שדות ל-Android SDK Place.Field.ACCESSIBILITY_OPTIONS*    * משתמשים במקום Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (הוצאה משימוש) Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME*    * משתמשים במקום Place.Field.NAME (הוצאה משימוש) Place.Field.FORMATTED_ADDRESS*    * משתמשים במקום Place.Field.ADDRESS (הוצאה משימוש) Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*    * משתמשים במקום Place.Field.ICON_URL (הוצאה משימוש) Place.Field.ID Place.Field.LOCATION*    * משתמשים במקום Place.Field.LAT_LNG (הוצאה משימוש) 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
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט Contact Data מופעל כשמתבצעת בקשה לאחד מהשדות הבאים: שדות ל-Android SDK Place.Field.CURRENT_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER*       * משתמשים במקום Place.Field.PHONE_NUMBER (הוצא משימוש). Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.WEBSITE_URI שדות ל-iOS SDK GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite שדות לשירות אינטרנט formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website
	חיוב לפי אנונימיזציה של שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של Essentials וגם ממק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

המק"ט הזה מחויב על בקשות ל-Atmosphere Data API שמציינות את השדות שבמק"ט הזה.

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

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

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

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

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

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה
	טריגרים	החיוב מופעל עבור: Android: findAutocompletePredictions() iOS: findAutocompletePredictionsFromQuery: JavaScript: שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API שירות אינטרנט: השירות של Places API להשלמה אוטומטית של שמות מקומות
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Pro
	אירוע לחיוב	סשן
	טריגרים	החיוב מופעל אם האפליקציה שולחת את שתי הבקשות האלה בסשן אחד: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... שירות אינטרנט בקשה להשלמה אוטומטית של מקום (input="par", session_token: XYZ) בקשה להשלמה אוטומטית של מקום (input="paris", session_token: XYZ) כשמציגים את החיוב לפי מק"ט, המק"ט הזה מופיע ברשימה: השלמה אוטומטית ללא פרטי מקום – לכל סשן
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

הערה: אפשר לראות את המק"ט הזה בדוחות החיוב, אבל לא בדף Billing > Pricing במסוף Google Cloud.

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

	קטגוריה	Essentials
	אירוע לחיוב	סשן
	טריגרים	המק"ט השלמה אוטומטית (כולל פרטי מקום) – לכל סשן מחויב על סשן השלמה אוטומטית שמבקש פרטי מקום. באופן ספציפי: Android: קריאה ל-fetchPlace() iOS: קריאה ל-fetchPlaceFromPlaceID: שירות אינטרנט: בקשה לקבלת פרטי מקום השדות בבקשה: חשוב לציין בבקשה את השדות הנחוצים כדי להימנע מחיובים מיותרים. בהתאם לשדות שציינתם, בקשה לפרטים של מקום יוצרת גם את המק"טים הבאים של נתונים: נתונים בסיסיים (Essentials) מקומות – נתוני אנשי קשר (Enterprise) Places – Atmosphere (Enterprise) אם לא מציינים שדות בבקשה לפרטים על המקום, כל המק"טים של הנתונים מופעלים. אם מבקשים רק רענון של מזהה פרטי המקום (הבקשה כוללת רק את השדה place_id) במהלך סשן של השלמה אוטומטית, הסשן מחויב בתור מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן.
	דוגמאות	בדוגמה הזו מוצגת סדרה של בקשות, לפי פלטפורמה, שיובילו למק"טים הבאים בחשבונית, כשתציגו את החשבונית לפי מק"ט: השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן פרטי מקומות נתונים בסיסיים דוגמה לבקשה לפי פלטפורמה: בקשות ל-Android findAutocompletePredictions() (‎.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (‎.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (עם FetchPlaceRequest שכולל את מזהה המקום ואת השדה ADDRESS) בקשות ל-iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (כולל מזהה המקום והשדה GMSPlaceFieldFormattedAddress) בקשות לשירותי אינטרנט בקשה להשלמה אוטומטית של מקומות (input="par", session_token: XYZ) בקשה להשלמה אוטומטית של מקומות (input="paris", session_token: XYZ) פרטי מקומות (place_id, session_token: XYZ, fields:formatted_address)
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

המק"ט הקודם הזה מחויב על בקשות להשלמה אוטומטית של שאילתות.

	קטגוריה	Essentials
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כששולחים בקשה להשלמתה אוטומטית של שאילתות באמצעות השירותים הבאים: JavaScript: השירות של Maps JavaScript API להשלמה אוטומטית של מקומות (getQueryPredictions()) והשימוש בווידג'ט SearchBox של Maps JavaScript API (בקשות להשלמה אוטומטית של שאילתות נוצרות בזמן שהמשתמש מקלידים). שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות ב-Places API אין תמיכה בתמחור לפי סשן של השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. על בקשות נוספות לקבלת פרטי מקום תחויבו לפי מק"ט Place Details Pro.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Place Details Pro

המק"ט הזה מחויב על בקשות קודמות לקבלת פרטים על מקומות.

	קטגוריה	Pro
	אירוע לחיוב	בקשה
	טריגרים	החיוב מופעל על בקשות מממשקי ה-API הבאים: Android: Places SDK ל-Android (fetchPlace()) iOS: Places SDK ל-iOS (fetchPlaceFromPlaceID:) JavaScript: שירות פרטי המקומות של Maps JavaScript API (getDetails) JavaScript: ווידג'ט של מילוי אוטומטי של מקומות ב-Maps JavaScript API (getPlace) JavaScript: ווידג'ט של תיבת חיפוש מקומות ב-Maps JavaScript API: השיטה getPlaces() אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדלור), כפי שמוצג כאן: בתוצאות של הווידג'ט של תיבת החיפוש, אחרי שמקלידים 'פיצה' בתיבת החיפוש, רואים שלצד Pizza Autentico מופיע סמל סיכה, שמציין שמדובר בתוצאת חיפוש של מקום (ולא בשאילתה). שירות אינטרנט: שירות פרטי המקומות של Places API כשמשתמשים ב-API לאינטרנט ובשירותים, החיוב על המק"ט של פרטי המקום מתבצע גם אם מספקים אסימון סשן וגם אם לא. המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם תכללו שדות נתונים בבקשה, היא עשויה להפעיל חיוב נוסף על מק"טים של נתונים: Basic,‏ Contact ו-Atmosphere. כדי להימנע מעלויות מיותרות, עליכם לציין רק את שדות הנתונים הרלוונטיים. אתם מחויבים על המק"ט הזה וגם על הנתונים שאתם מבקשים.
	דוגמאות	מבצעים את אחת מהפעולות הבאות: נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה ADDRESS Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address) המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט): פרטי מקומות נתונים בסיסיים מבצעים את אחת מהפעולות הבאות: נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה PHONE_NUMBER שירות או ממשק API לאינטרנט: שולחים בקשה לקבלת פרטי מקום ומציינים את השדה של מספר הטלפון: getPlaceDetails(fields: formatted_phone_number) המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט): פרטי מקומות פרטי איש קשר מבצעים את אחת מהפעולות הבאות: נייד: מחייגים למספר fetchPlace() ב-Android או למספר fetchPlaceFromPlaceID: ב-iOS ומציינים את כל השדות Web API או שירות: שולחים בקשה לפרטים של מקום ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות): getPlaceDetails(). המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט): פרטי מקומות נתונים בסיסיים פרטי איש קשר נתוני אטמוספרה
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

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

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

המק"ט הזה מחויב על בקשות ל'חיפוש מקום' שמחזירות יותר שדות מאשר רק מזהה המקום.

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

	קטגוריה	Pro
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מחויב על בקשות לשיטות הבאות: חיפוש המקום הנוכחי המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם תכללו שדות נתונים בבקשה, היא עשויה להפעיל חיוב נוסף על מק"טים של נתונים: Basic,‏ Contact ו-Atmosphere. כדי להימנע מעלויות מיותרות, עליכם לציין רק את שדות הנתונים הרלוונטיים. אתם מחויבים על המק"ט הזה וגם על הנתונים שאתם מבקשים.
	דוגמאות	בדוגמאות הבאות מוצגים המק"טים שאתם מחויבים עליהם כשאתם שולחים בקשה לאיתור המיקום הנוכחי ומציינים שדות מהמק"טים של נתוני 'בסיסי', 'אנשי קשר' ו'אטמוספרה'. כדי לראות את המק"טים בחשבונית, אפשר להציג את החשבונית לפי מק"ט כפי שמתואר בקטע ניתוח השימוש והעלות לכל מק"ט. שולחים בקשה לחיפוש מקום עם השדה ADDRESS בלבד: החיובים שלך כוללים את המק"טים הבאים: חיפוש המקום הנוכחי נתונים בסיסיים שולחים בקשה לחיפוש מקום עם השדה PHONE_NUMBER בלבד: החשבונית כוללת את המק"טים הבאים: חיפוש המקום הנוכחי פרטי איש קשר שולחים בקשה לחיפוש מקום עם כל שלושת השדות של סוגי הנתונים: החשבונית כוללת את המק"טים הבאים: חיפוש המקום הנוכחי נתונים בסיסיים פרטי איש קשר נתוני אטמוספרה
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה
	טריגרים	שולחים בקשה לחיפוש מקום בלי לציין שדות, או שצוינים רק את השדה place_id: FindPlace(fields: place_id).
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Pro
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כששולחים בקשה לחיפוש בקרבת מקום באמצעות אחד מה-API הבאים: שירות החיפוש של מקומות בקרבת מקום ב-Maps JavaScript API (nearbySearch()) שירות החיפוש בקרבת מקום של Places API הבקשה הזו לא תומכת בציינה של השדות להחזרה. התגובה מחזירה רשימה של מקומות וקבוצת משנה של שדות הנתונים הנתמכים. המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם תכללו שדות נתונים בבקשה, היא עשויה להפעיל חיוב נוסף על מק"טים של נתונים: Basic,‏ Contact ו-Atmosphere. כדי להימנע מעלויות מיותרות, עליכם לציין רק את שדות הנתונים הרלוונטיים. אתם מחויבים על המק"ט הזה וגם על הנתונים שאתם מבקשים.
	דוגמאות	שולחים בקשה לחיפוש בקרבת מקום, כמו NearbySearch (San Francisco, 100 meters). המק"טים האלה מופיעים בחשבונית כשמציגים את החשבונית לפי מק"ט: מקום נתונים בסיסיים פרטי איש קשר נתוני אטמוספרה
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

המק"ט הזה מחויב על בקשות לשירות Places Text Search.

	קטגוריה	Pro
	אירוע לחיוב	בקשה
	טריגרים	החיוב מופעל על בקשות לשירותים הבאים: שירות חיפוש טקסט של מקומות ב-Maps JavaScript API (textSearch()). שירות חיפוש טקסט של Places API בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא תומכות בתיוג של השדות שיוחזרו. בקשות לחיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על הבקשה לחיפוש טקסט ועל כל המק"טים של סוגי הנתונים: Basic Data,‏ Contact Data ו-Atmosphere Data. המק"ט 'מקום – חיפוש טקסט' מופעל גם על ידי השיטה getPlaces() של הווידג'ט Place SearchBox של ממשק API של JavaScript במפות Google, אחרי שהמשתמש בוחר שאילתה לגבי מקום (סמל: זכוכית מגדלת), לא תוצאה (סמל: סיכה), כפי שמוצג כאן: בתוצאות של ווידג'ט תיבת החיפוש, אחרי שמקלידים 'פיצה' בתיבת החיפוש, רואים שלצד משלוח פיצה מופיע סמל של מגדיל, שמציין שמדובר בשאילתת חיפוש של מקום (ולא בתוצאה).
	דוגמה	אם שולחים בקשה לחיפוש טקסט, כמו TextSearch(123 Main Street), המק"טים הבאים יופיעו בחשבונית כשמציגים את החשבונית לפי מק"ט: מקום – חיפוש טקסט נתונים בסיסיים פרטי איש קשר נתוני אטמוספרה
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: תמונות של פרטי מקום ב-Places API

המק"ט הזה מחויב על שירות התמונות הקודם של מפות Google.

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

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

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

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

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

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

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

---