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

Places SDK לשימוש ולחיוב ב-Android

שגיאה: 9005‏ PLACES_API_RATE_LIMIT_EXCEEDED

לוחצים על הסמל info info כדי להציג את תוכן העניינים של הדף הזה.

חיוב ותמחור של Places SDK ל-Android

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

פרטי המק"ט של המוצר של Places SDK ל-Android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.PHOTO_METADATAS` `Place.Field.RESOURCE_NAME` שדות שיצאו משימוש: השדה `Place.Field.NAME` הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.DISPLAY_NAME`. השדה `RESOURCE_NAME` מכיל את שם המשאב של המקום בפורמט: `places/PLACE_ID`. מקישים על `DISPLAY_NAME` כדי לגשת לשם הטקסט של המקום.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Essentials

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את שדות המיקום הבאים: Android: `Place.Field.ADDRESS_COMPONENTS` `ADR_FORMAT_ADDRESS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.LOCATION` `Place.Field.PLUS_CODE` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.TYPES` `Place.Field.VIEWPORT` שדות שיצאו משימוש: השדות `Place.Field.ADDRESS` ו-`Place.Field.LAT_LNG` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.FORMATTED_ADDRESS` וב-`Place.Field.LOCATION`, בהתאמה.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Pro

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

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.BUSINESS_STATUS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SUB_DESTINATIONS` `Place.Field.UTC_OFFSET` שדות שיצאו משימוש: השדות `Place.Field.ICON_URL` ו-`Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.ICON_MASK_URL` וב-`Place.Field.ACCESSIBILITY_OPTIONS`, בהתאמה. האפשרות `Place.Field.ACCESSIBILITY_OPTIONS` זמינה רק לפרטי מקום (חדש).
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Place Details Enterprise

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` שדות שיצאו משימוש:השדות `Place.Field.PHONE_NUMBER` ו-`Place.Field.USER_RATINGS_TOTAL` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.INTERNATIONAL_PHONE_NUMBER` וב-`Place.USER_RATING_COUNT`, בהתאמה. אם תסיימו סשן של השלמה אוטומטית באמצעות קריאה ל-Place Details שמבקשת כל שדה מ-SKU: Place Details (Basic, Advanced, or Preferred), הקריאה תחויב לפי SKU: Place Details (Preferred). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT` אם סשן של השלמה אוטומטית מסתיים בקריאה לפרטים של מקום שמבקשת כל שדה מ-מק"ט: פרטים של מקום (בסיסי, מתקדם או מועדף), החיוב על הקריאה מתבצע לפי מק"ט: פרטים של מקום (מועדף). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Nearby Search Pro

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

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר: Android: `Place.Field.ADDRESS_COMPONENTS` `Place.Field.BUSINESS_STATUS` `Place.Field.ADDRESS` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_URL` `Place.Field.LAT_LNG` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.ID` `Place.Field.NAME` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Nearby Search Enterprise

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` שדות שיצאו משימוש:השדות `Place.Field.PHONE_NUMBER` ו-`Place.Field.USER_RATINGS_TOTAL` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.INTERNATIONAL_PHONE_NUMBER` וב-`Place.USER_RATING_COUNT`, בהתאמה.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים: Android: `Place.Field.DISPLAY_NAME` `Place.Field.ID` `Place.Field.RESOURCE_NAME` שדות שיצאו משימוש: השדה `Place.Field.NAME` הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.DISPLAY_NAME`. השדה `RESOURCE_NAME` מכיל את שם המשאב של המקום בפורמט: `places/PLACE_ID`. מקישים על `DISPLAY_NAME` כדי לגשת לשם הטקסט של המקום.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Pro

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

	קטגוריה	Pro
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם תמחור נמוך יותר: Android: `Place.Field.ACCESSIBILITY_OPTIONS` `Place.Field.ADDRESS_COMPONENTS` `Place.Field.ADR_FORMAT_ADDRESS` `Place.Field.BUSINESS_STATUS` `Place.Field.FORMATTED_ADDRESS` `Place.Field.GOOGLE_MAPS_URI` `Place.Field.ICON_BACKGROUND_COLOR` `Place.Field.ICON_MASK_URL` `Place.Field.LOCATION` `Place.Field.PHOTO_METADATAS` `Place.Field.PLUS_CODE` `Place.Field.PRIMARY_TYPE` `Place.Field.PRIMARY_TYPE_DISPLAY_NAME` `Place.Field.SHORT_FORMATTED_ADDRESS` `Place.Field.SUB_DESTINATIONS` `Place.Field.TYPES` `Place.Field.UTC_OFFSET` `Place.Field.VIEWPORT` שדות שהוצאו משימוש: השדות `Place.Field.ADDRESS`,‏ `Place.Field.ICON_URL`,‏ `Place.Field.LAT_LNG` ו-`Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.FORMATTED_ADDRESS`, ב-`Place.Field.ICON_MASK_URL`, ב-`Place.Field.LOCATION` וב-`Place.ACCESSIBILITY_OPTIONS`, בהתאמה. האפשרות `Place.Field.ACCESSIBILITY_OPTIONS` זמינה רק לפרטי מקום (חדש).
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Places API Text Search Enterprise

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.CURRENT_OPENING_HOURS` `Place.Field.CURRENT_SECONDARY_OPENING_HOURS` `Place.Field.INTERNATIONAL_PHONE_NUMBER` `Place.Field.NATIONAL_PHONE_NUMBER` `Place.Field.OPENING_HOURS` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.SECONDARY_OPENING_HOURS` `Place.Field.USER_RATING_COUNT` `Place.Field.WEBSITE_URI` שדות שיצאו משימוש:השדות `Place.Field.PHONE_NUMBER` ו-`Place.Field.USER_RATINGS_TOTAL` הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, צריך להשתמש ב-`Place.Field.INTERNATIONAL_PHONE_NUMBER` וב-`Place.USER_RATING_COUNT`, בהתאמה.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה
	טריגרים	המק"ט הזה מופעל כשמבקשים את השדות הבאים: Android: `Place.Field.ALLOWS_DOGS` `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.DINE_IN` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.EV_CHARGE_OPTIONS` `Place.Field.FUEL_OPTIONS` `Place.Field.GOOD_FOR_CHILDREN` `Place.Field.GOOD_FOR_GROUPS` `Place.Field.GOOD_FOR_WATCHING_SPORTS` `Place.Field.LIVE_MUSIC` `Place.Field.MENU_FOR_CHILDREN` `Place.Field.OUTDOOR_SEATING` `Place.Field.PARKING_OPTIONS` `Place.Field.PAYMENT_OPTIONS` `Place.Field.RESERVABLE` `Place.Field.RESTROOM` `Place.Field.REVIEWS` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_COCKTAILS` `Place.Field.SERVES_COFFEE` `Place.Field.SERVES_DESSERT` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT`
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

מק"ט: Place Details Photos

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

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

פרטי המק"טים הקודמים של Places SDK ל-Android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

	קטגוריה	Essentials
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	המק"ט 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`. שדות שהוצאו משימוש:השדות הבאים הוצאו משימוש בגרסה 4.0 של Places SDK ל-Android: `Place.Field.ADDRESS`,‏ `Place.Field.ICON_URL`,‏ `Place.Field.LAT_LNG`,‏ `Place.Field.NAME` ו- `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` שדות. במקום זאת, צריך להשתמש בשדות `Place.Field.FORMATTED_ADDRESS`,‏ `Place.Field.ICON_MASK_URL`, `Place.Field.LOCATION`, `Place.Field.DISPLAY_NAME` ו-`Place.ACCESSIBILITY_OPTIONS`, בהתאמה. השדה `Place.Field.ACCESSIBILITY_OPTIONS` זמין רק לפרטי מקום (חדש). iOS: `GMSPlaceFieldFormattedAddress` `GMSPlaceFieldBusinessStatus` `GMSPlaceFieldID` `GMSPlaceFieldCoordinate` `GMSPlaceFieldName` `GMSPlaceFieldPhotos` `GMSPlaceFieldPlusCode` `GMSPlaceFieldTypes` `GMSPlaceFieldViewport` שירות אינטרנט: `address_component` `adr_address` `business_status` `formatted_address` `geometry` `icon` `name` `permanently_closed` `photo` `place_id` `plus_code` `type` `url` `utc_offset` `vicinity` `wheelchair_accessible_entrance`
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של Essentials ומק"ט של Enterprise, הבקשה תחויב לפי התעריף של המק"ט של Enterprise.
	Pricing	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

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

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

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

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

	קטגוריה	Enterprise
	אירוע לחיוב	בקשה עם מסכות השדות שצוינו.
	טריגרים	החיוב מופעל כשמבקשים את אחד מהשדות הבאים: Android `Place.Field.CURBSIDE_PICKUP` `Place.Field.DELIVERY` `Place.Field.EDITORIAL_SUMMARY` `Place.Field.DINE_IN` `Place.Field.PRICE_LEVEL` `Place.Field.RATING` `Place.Field.RESERVABLE` `Place.Field.SERVES_BEER` `Place.Field.SERVES_BREAKFAST` `Place.Field.SERVES_BRUNCH` `Place.Field.SERVES_DINNER` `Place.Field.SERVES_LUNCH` `Place.Field.SERVES_VEGETARIAN_FOOD` `Place.Field.SERVES_WINE` `Place.Field.TAKEOUT` `Place.Field.USER_RATING_COUNT` שדות שהוצאו משימוש: השדה `Place.Field.USER_RATINGS_TOTAL` הוצא משימוש בגרסה 4.0 של Places SDK ל-Android. במקום זאת, אתם צריכים להשתמש ב-`Place.Field.USER_RATING_COUNT`.
	דוגמאות לחיוב באמצעות מסכת שדות	אלה דוגמאות לאופן החיוב של הבקשה על סמך השדות שבוחרים במסכת השדות. אם מסכת השדות של הבקשה כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. לדוגמה, אפשר לבקש שדה אחד או יותר מהמק"ט הזה, והחיוב יתבצע לפי התעריף של המק"ט הזה. אם מסכת שדות הבקשה כוללת שדות של מק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות מכמה מק"טים, כמו מק"ט של 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	טבלת התמחור הראשית טבלת התמחור בהודו

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

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

	קטגוריה	Essentials
	אירוע לחיוב	סשן
	טריגרים	ה-SKU השלמה אוטומטית (כלולה בפרטים של מקומות) – לכל סשן מחויב על סשן השלמה אוטומטית שכולל אחת מהבקשות הבאות: Android: קריאה ל-`fetchPlace()` iOS: קריאה ל-`fetchPlaceFromPlaceID:` שירות אינטרנט: בקשה לקבלת פרטי מקום בקשה לפרטים על מקום יוצרת מק"טים של נתונים (Basic,‏ Contact ו/או Atmosphere) בהתאם לשדות שציינתם בבקשה. אם לא מבקשים שדות ספציפיים בבקשה לפרטים על המקום, כל המק"טים של נתונים מופעלים (Essentials,‏ Pro,‏ Enterprise ו-Enterprise + Atmosphere). כדי להימנע מחיובים מיותרים, עליכם לציין רק את השדות הנחוצים לכם. אם מבקשים רק לרענן את מזהה פרטי המקום (הבקשה כוללת רק את השדה `place_id`) במהלך סשן השלמה אוטומטית, הסשן יחויב כ-SKU: Autocomplete without Place Details – Per Session.
	דוגמאות	אם האפליקציה שלכם מבצעת את שלוש הקריאות הבאות בסשן אחד: 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	טבלת התמחור הראשית טבלת התמחור בהודו

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

מק"ט: Find Current Place

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

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

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

מק"ט: Places API Place Details Photos

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

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

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

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