פרטי המק"טים של Places (New)‎

בדף הזה מפורטים המק"טים, מזהי המק"טים, האירועים לחיוב והטריגרים לחיוב של Google Maps Platform Places (New),‏ Places UI Kit,‏ Places Aggregate API,‏ Address Validation API,‏ Geocoding API,‏ Geolocation API,‏ Time Zone API ו-Maps Experience Agent Tools. למידע על מק"טים מדור קודם של Places, קראו את המאמר פרטי מק"טים מדור קודם של Places ו-Routes. בסקירה הכללית של פרטי השימוש ב-API מופיעה רשימה של כל קטגוריות המוצרים. למחירי המק"טים, עיינו במחירונים הגלובליים ובמחירונים של הודו.

מידע על טבלאות המק"טים

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

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

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

ב-Place Details (חדש), ב-חיפוש בסביבה (חדש) וב-חיפוש טקסט (חדש), הבקשה מחויבת על סמך השדות שצוינו במסכת השדות:

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

לרשימה מלאה של השדות והמק"טים שמשויכים אליהם לפי פלטפורמה, ראו:

• Android SDK: שדות נתונים של מקומות (חדש)
• iOS SDK: שדות נתונים של מקומות (חדש)
• ספריית מקומות, Maps JavaScript API: שדות נתונים של מחלקת Place
• שירות אינטרנט: שדות נתונים של מקומות (חדש)

מק"טים של מוצרי Places (New)‎

‫[ Essentials: Places, Geocoding, Geolocation ]

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

	קטגוריה	Essentials
	מזהה המק"ט	‫4EF4-B17C-B31A (כל העולם) F155-0371-DCAE (הודו)
	ממשקי API	השלמה אוטומטית למקומות באנדרואיד, השלמה אוטומטית למקומות ב-iOS, ווידג'ט השלמה אוטומטית למקומות ב-API של מפות Google JavaScript, השלמה אוטומטית למקומות באינטרנט
	אירוע לחיוב	בקשה בלי טוקן לסשן, או עם טוקן לא תקין או שפג תוקפו
	טריגרים	המק"ט הזה מופעל בתנאים הבאים: הבקשה לא כוללת טוקן לסשן. הבקשה כוללת טוקן לסשן, אבל אתם נוטשים את הסשן. הבקשה כוללת טוקן לסשן, אבל אתם מסיימים את הסשן בתנאים מסוימים. למידע על השימוש בסשנים של השלמה אוטומטית, ראו טוקנים לסשן או מק"ט: שימוש בסשנים של השלמה אוטומטית.
	דוגמאות	כדי להגביל את מספר הבקשות שמחויבות במהלך סשן אחד של השלמה אוטומטית, אתם יכולים להשתמש בסשנים. פרטים נוספים זמינים במאמר אסימונים של סשנים או במאמר מק"ט: שימוש בהשלמה אוטומטית בסשן.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

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

	קטגוריה	Essentials
	מזהה המק"ט	‫EEA3-417B-DBA1 (כל העולם) 4764-9FA0-0FC0 (הודו)
	ממשקי API	השלמה אוטומטית למקומות באנדרואיד, השלמה אוטומטית למקומות ב-iOS, ווידג'ט השלמה אוטומטית למקומות ב-API של מפות Google JavaScript, השלמה אוטומטית למקומות באינטרנט
	אירוע לחיוב	בקשה עם טוקן לסשן
	טריגרים	מידע נוסף זמין במאמר השלמה אוטומטית (חדשה) ותמחור לפי סשן. אם הסשן מסתיים בבקשה מסוג Place Details Essentials, 12 הבקשות הראשונות להשלמה אוטומטית מחויבות לפי מק"ט: בקשות להשלמה אוטומטית. כל בקשות ההשלמה האוטומטית הבאות מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית.
	דוגמאות	המק"ט הזה משמש כמעטפת למק"ט של בקשות ההשלמה האוטומטית (חדש), ומאפשר להגביל את מספר הבקשות שמחויבות במהלך סשן אחד של השלמה אוטומטית. למידע על השימוש בסשנים של השלמה אוטומטית, ראו טוקנים לסשנים. הערה: אם אתם לא משתמשים בסשנים עם ההשלמה האוטומטית (חדש), אתם מחויבים על כל בקשה להשלמה אוטומטית באמצעות המק"ט: בקשות להשלמה אוטומטית.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: המרת כתובות לקואורדינטות (geocoding)

	קטגוריה	Essentials
	מזהה המק"ט	‫BAC8-4E68-E261 (גלובלי) AB12-DA89-B523 (הודו)
	ממשקי API	שירות המרת כתובות לקואורדינטות (geocoding) של Maps JavaScript API, Geocoding API
	אירוע לחיוב	בקשה שהושלמה בהצלחה
	טריגרים	‫JavaScript: השיטה Geocoder.geocode() Geocoding API
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: מיקום גיאוגרפי

	קטגוריה	Essentials
	מזהה המק"ט	‫51AF-D64F-9ABD (כל העולם) 8D4A-1891-61DA (הודו)
	ממשקי API	Geolocation API
	אירוע לחיוב	בקשה שהושלמה בהצלחה
	טריגרים	בקשה ל-Geolocation API
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Maps Grounding Essentials

	קטגוריה	Essentials
	מזהה המק"ט	‫8CD0-1602-5324 (כל העולם) E1E0-C20B-1C60 (הודו)
	ממשקי API	כלי סוכן ל-Maps Experience
	אירוע לחיוב	בקשה לכלי הסוכן של Maps Experiments
	טריגרים	בקשה ל-Maps Experience Agent Tools שלא משתמשת באפשרויות Pro, או שמגיעה מפרויקט שלא מופעלת בו גרסת Pro. במקום זאת, בקשות ל-Resolution API (ResolveNames ו-ResolveMapsUrls) מחויבות במסגרת המק"ט Places API Text Search Essentials (IDs Only).
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API Place Details Essentials (מזהים בלבד)

	קטגוריה	Essentials
	מזהה המק"ט	‫5C36-E272-E88F (כל העולם) FAA1-1118-93BE (הודו)
	ממשקי API	פרטי מקומות ב-Places API
	אירוע לחיוב	בקשה מוצלחת לשדות מזהים בלבד
	טריגרים	שדות ל-Android SDK Place.Field.ID Place.Field.PHOTO_METADATAS Place.Field.RESOURCE_NAME הערה: השדה RESOURCE_NAME מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. כדי לגשת לשם הטקסט של המקום, משתמשים ב-DISPLAY_NAME במק"ט Pro. שדות ל-iOS GMSPlacePropertyPlaceID GMSPlacePropertyPhotos שדות של ספריית המקומות, Maps JavaScript API id photos שדות לשירות אינטרנט attributions consumerAlert id movedPlace movedPlaceId name^* photos ‫^* השדה name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. כדי לקבל את השם של המקום בטקסט, צריך לבקש את השדה displayName במק"ט Pro. סיום סשן באמצעות בקשה מסוג Place Details Essentials (IDs Only) שווה ערך לאי-שימוש בסשן. כל הבקשות להשלמה אוטומטית במהלך סשן מחויבות לפי מק"ט: בקשות להשלמה אוטומטית.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API Place Details Essentials

	קטגוריה	Essentials
	מזהה המק"ט	‫6E05-E1C3-8D85 (כל העולם) 8036-9499-4AF9 (הודו)
	ממשקי API	פרטי מקום (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות Essentials בלבד אם סשן של השלמה אוטומטית מסתיים בבקשה שכוללת רק שדות של המק"ט Place Details Essentials, החיוב על 12 הבקשות הראשונות להשלמה אוטומטית מתבצע לפי המק"ט Autocomplete Requests. כל בקשות ההשלמה האוטומטית הבאות מחויבות לפי מק"ט: שימוש בסשן של השלמה אוטומטית. הבקשה הסופית של Place Details מחויבת לפי SKU: Place Details Essentials.
	טריגרים	שדות ל-Android SDK Place.Field.ADDRESS_COMPONENTS ADR_FORMAT_ADDRESS Place.Field.FORMATTED_ADDRESS*     * צריך להשתמש במקום Place.Field.ADDRESS (הוצא משימוש). Place.Field.LOCATION*     * צריך להשתמש במקום Place.Field.LAT_LNG (הוצא משימוש). Place.Field.PLUS_CODE Place.Field.SHORT_FORMATTED_ADDRESS Place.Field.TYPES Place.Field.VIEWPORT שדות ל-iOS GMSPlacePropertyAddressComponents GMSPlacePropertyFormattedAddress GMSPlacePropertyCoordinate GMSPlacePropertyPlusCode GMSPlacePropertyTypes GMSPlacePropertyViewport שדות של ספריית המקומות, Maps JavaScript API addressComponents adrFormatAddress formattedAddress location plusCode types viewport שדות לשירות אינטרנט addressComponents addressDescriptor^* adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport ^* תיאורי מיקום זמינים לכלל המשתמשים בהודו, ובמקומות אחרים הם בשלב ניסיוני.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

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

	קטגוריה	Essentials
	מזהה המק"ט	‫635D-A9DD-C520 (כל העולם) 9C44-5A2D-4E06 (הודו)
	ממשקי API	חיפוש טקסט (חדש) Maps Grounding Lite Resolution API
	אירוע לחיוב	בקשה מוצלחת למזהים בלבד
	טריגרים	Android SDK Place.Field.DISPLAY_NAME*     * צריך להשתמש במקום Place.Field.NAME (הוצא משימוש בגרסה 4.0). Place.Field.ID Place.Field.RESOURCE_NAME*     * מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID.      משתמשים ב-DISPLAY_NAME כדי לגשת לשם הטקסט של המקום. iOS GMSPlacePropertyPlaceID ספריית מקומות, Maps JavaScript API id שירות אינטרנט places.attributions places.id places.consumerAlert places.name^* nextPageToken places.movedPlace places.movedPlaceId ‫^* השדה places.name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. כדי לגשת לשם הטקסט של המקום, משתמשים ב-places.displayName במק"ט Pro. Maps Grounding Lite בקשה ל-method‏ ResolveNames או ResolveMapsUrls של Resolution API. הבקשות האלה לא מחויבות בתשלום.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: שאילתה ב-Places UI Kit

	קטגוריה	Essentials
	מזהה המק"ט	‫0678-4F72-DA7C (כל העולם) B10D-0B66-6EAD (הודו)
	ממשקי API	‫Places UI Kit ל-Android, ‫Places UI Kit ל-iOS, ‫Places UI Kit ל-JavaScript
	אירוע לחיוב	בקשה לרכיבים של Place Details או חיפוש מקומות באמצעות Places UI Kit
	טריגרים	המק"ט הזה מופעל על ידי בקשות לרכיבים Place Details ו-חיפוש מקומות מ-Places UI Kit. המשתמשים מחויבים רק על המק"ט הזה לכל בקשה של Places UI Kit, בלי קשר לשדות שמוצגים ב-UI Kit. Android רכיב Place Details רכיב חיפוש מקומות iOS רכיב Place Details רכיב חיפוש מקומות JavaScript רכיבים של Place Details רכיבים של חיפוש מקומות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places UI Kit – השלמה אוטומטית לסשן

	קטגוריה	Essentials
	מזהה המק"ט	‫924B-2797-26F1 (כל העולם) 1EC3-B6E6-F9B9 (הודו)
	ממשקי API	‫Places UI Kit ל-Android, ‫Places UI Kit ל-iOS, ‫Places UI Kit ל-JavaScript
	אירוע לחיוב	סשן
	טריגרים	המק"ט הזה מופעל על ידי בקשות השלמה אוטומטית בסיסיות של Places UI Kit: Android רכיב בסיסי של השלמה אוטומטית iOS רכיב בסיסי של השלמה אוטומטית JavaScript רכיב בסיסי של השלמה אוטומטית
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: אזור זמן

	קטגוריה	Essentials
	מזהה המק"ט	‫91DF-9B59-4BBD (גלובלי) 0301-2887-FE47 (הודו)
	ממשקי API	Time Zone API
	אירוע לחיוב	בקשה מוצלחת ל-Time Zone API
	טריגרים	בקשה ל-Time Zone API.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

[ Pro: Address Validation, Places ]

מק"ט: Address Validation Pro

	קטגוריה	Pro
	מזהה המק"ט	‫A2E0-53FF-0BE3 (גלובלי) 4EB5-381D-BD8E (הודו)
	ממשקי API	Address Validation API
	אירוע לחיוב	בקשה מוצלחת ל-Address Validation API
	טריגרים	השיטה ValidateAddress (REST) השיטה ValidateAddress (gRPC)
	תמחור	מחירון (גלובלי) מחירון (הודו)

הערה: בקשות למשוב על אימות לא מחויבות בתשלום. שיטות המשוב האלה ללא חיוב הן: provideValidationFeedback (ב-REST) ו-ProvideValidationFeedback (ב-gRPC).

( חזרה לראש הדף )

מק"ט: Places API חיפוש בסביבה Pro

	קטגוריה	Pro
	מזהה המק"ט	‫99F9-A108-83A6 (כל העולם) 33DE-5C83-8354 (הודו)
	ממשקי API	חיפוש בסביבה (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות של Pro
	טריגרים	Android SDK Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.ADDRESS Place.Field.DISPLAY_NAME >*     * צריך להשתמש במקום Place.Field.NAME, שהוצא משימוש. Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*     * צריך להשתמש בו במקום ב-Place.Field.ICON_URL, שהוצא משימוש. Place.Field.ID Place.Field.LAT_LNG Place.Field.PHOTO_METADATAS Place.Field.PLUS_CODE Place.Field.PRIMARY_TYPE Place.Field.PRIMARY_TYPE_DISPLAY_NAME Place.Field.RESOURCE_NAME Place.Field.TYPES Place.Field.UTC_OFFSET Place.Field.VIEWPORT Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE iOS SDK GMSPlacePropertyAddressComponents GMSPlacePropertyBusinessStatus GMSPlacePropertyCoordinate GMSPlacePropertyFormattedAddress GMSPlacePropertyName GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyPhotos GMSPlacePropertyPlaceID GMSPlacePropertyPlusCode GMSPlacePropertyTypes GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyViewport GMSPlacePropertyWheelchairAccessibleEntrance ספריית מקומות, Maps JavaScript API accessibilityOptions addressComponents adrFormatAddress businessStatus displayName formattedAddress googleMapsUri iconBackgroundColor id location photos plusCode svgIconMaskURI types utcOffsetMinutes viewport שירות אינטרנט places.accessibilityOptions places.addressComponents places.addressDescriptor^* places.adrFormatAddress places.attributions places.businessStatus places.consumerAlert places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks places.googleMapsTypeLabel places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.id places.location places.name^** places.movedPlace places.movedPlaceId places.openingDate places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.timeZone places.types places.utcOffsetMinutes places.viewport ^* תיאורי כתובות זמינים לכלל המשתמשים בהודו, ובמקומות אחרים הם זמינים כרגע רק כניסוי. ^** השדה places.name מכיל את שם המשאב של המקום, בפורמט: places/PLACE_ID. משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API Place Details Pro

	קטגוריה	Pro
	מזהה המק"ט	‫4ED6-464A-2AFC (כל העולם) ‫1F70-206B-61DF (הודו)
	ממשקי API	פרטי מקומות ב-Places API
	אירוע לחיוב	בקשה מוצלחת לשדות של Pro
	טריגרים	שדות ל-Android SDK Place.Field.ACCESSIBILITY_OPTIONS*     * צריך להשתמש במקום Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (הוצא משימוש). Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME*     * צריך להשתמש בו במקום ב-Place.Field.NAME, שהוצא משימוש. Place.Field.GOOGLE_MAPS_URI Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*     * צריך להשתמש במקום Place.Field.ICON_URL (הוצא משימוש). Place.Field.PRIMARY_TYPE Place.Field.PRIMARY_TYPE_DISPLAY_NAME Place.Field.SUB_DESTINATIONS Place.Field.UTC_OFFSET שדות ל-iOS GMSPlacePropertyBusinessStatus GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyName GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyWheelchairAccessibleEntrance שדות של ספריית המקומות, Maps JavaScript API accessibilityOptions businessStatus displayName googleMapsUri iconBackgroundColor primaryTypeDisplayName svgIconMaskURI utcOffsetMinutes שדות לשירות אינטרנט accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks googleMapsTypeLabel googleMapsUri iconBackgroundColor iconMaskBaseUri openingDate primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations timeZone utcOffsetMinutes אם מסיימים סשן של השלמה אוטומטית באמצעות קריאה ל-Place Details שמבקשת שדה כלשהו מהמק"ט SKU: Place Details Pro, Enterprise, או Enterprise + Atmosphere, הקריאה מחויבת לפי SKU: Place Details Enterprise + Atmosphere.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API חיפוש טקסט Pro

	קטגוריה	Pro
	מזהה המק"ט	‫4FDA-34B1-A910 (גלובלי) 2DB9-E41E-AC2A (הודו)
	ממשקי API	חיפוש טקסט (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות של Pro
	טריגרים	Android SDK Place.Field.ACCESSIBILITY_OPTIONS*     צריך להשתמש במקום Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (הוצא משימוש). Place.Field.ADDRESS_COMPONENTS Place.Field.ADR_FORMAT_ADDRESS Place.Field.BUSINESS_STATUS Place.Field.FORMATTED_ADDRESS*     צריך להשתמש במקום Place.Field.ADDRESS (הוצא משימוש). Place.Field.GOOGLE_MAPS_URI Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL *     צריך להשתמש במקום Place.Field.ICON_URL (הוצא משימוש). Place.Field.LOCATION*     צריך להשתמש במקום Place.Field.LAT_LNG (הוצא משימוש). 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 iOS GMSPlacePropertyAddressComponents GMSPlacePropertyBusinessStatus GMSPlacePropertyCoordinate GMSPlacePropertyFormattedAddress GMSPlacePropertyIconBackgroundColor GMSPlacePropertyIconImageURL GMSPlacePropertyName GMSPlacePropertyPhotos GMSPlacePropertyPlusCode GMSPlacePropertyTypes GMSPlacePropertyUTCOffsetMinutes GMSPlacePropertyViewport GMSPlacePropertyWheelchairAccessibleEntrance ספריית מקומות, Maps JavaScript API accessibilityOptions addressComponents adrFormatAddress businessStatus displayName formattedAddress googleMapsUri iconBackgroundColor location photos plusCode svgIconMaskURI types utcOffsetMinutes viewport שירות אינטרנט places.accessibilityOptions places.addressComponents places.addressDescriptor^* places.adrFormatAddress places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks places.googleMapsTypeLabel places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.location places.openingDate places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.searchUri places.subDestinations places.timeZone places.types places.utcOffsetMinutes places.viewport ^* תיאורי כתובות זמינים לכלל המשתמשים בהודו, ובמקומות אחרים הם זמינים כרגע רק כניסוי.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places Aggregate API

	קטגוריה	Pro
	מזהה המק"ט	‫546C-66B2-E5A6 (כל העולם) CA83-2F48-1131 (הודו)
	ממשקי API	Places Aggregate API
	אירוע לחיוב	בקשה מוצלחת לתכונות Pro
	טריגרים	computeInsights
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places UI Kit Pro (Advanced)‎

	קטגוריה	Pro
	מזהה המק"ט	‫42AB-1FB3-B56A (כל העולם) EA84-C46A-0634 (הודו)
	ממשקי API	‫Places UI Kit ל-Android ‫Places UI Kit ל-iOS ‫Places UI Kit ל-JavaScript
	אירוע לחיוב	בקשה ל-Advanced Place Details,‏ Advanced Place List,‏ חיפוש מקומות מתקדם או Place Markers באמצעות Places UI Kit
	טריגרים	המק"ט הזה מופעל על ידי בקשות ל-Advanced Place Details, ל-Advanced Place Search, ל-Advanced Place List ול-Place Markers מ-Places UI Kit. החיוב מתבצע רק על המק"ט הזה לכל בקשה של Places UI Kit, בלי קשר לשדות שמוצגים ב-UI Kit. iOS רכיב מתקדם של פרטי מקומות רכיב מתקדם של רשימת מקומות רכיב מתקדם של חיפוש מקומות רכיב של סמני מקומות Android רכיב מתקדם של פרטי מקומות רכיב מתקדם של רשימת מקומות רכיב מתקדם של חיפוש מקומות רכיב של סמני מקומות JavaScript רכיב מתקדם של פרטי מקומות רכיב מתקדם של רשימת מקומות רכיב מתקדם של חיפוש מקומות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

‫[ Enterprise: Address Validation, Places ]

שדות משותפים של טריגרים ב-Enterprise וב-Enterprise + Atmosphere

למק"טים של "חיפוש בסביבה (חדש)", "פרטי מקום (חדש)" ו"חיפוש טקסט (חדש)" ברמות Enterprise ו-Enterprise + Atmosphere יש אותם שדות טריגר בכל הפלטפורמות. בבקשות של שירות אינטרנט לחיפוש בסביבה (חדש) ולחיפוש טקסט (חדש), מוסיפים את הקידומת places. לכל שם שדה (לדוגמה, places.rating), חוץ מ-routingSummaries.

שדות של ביטויים להפעלה ב-Places Enterprise

Android SDK	iOS SDK	ספריית מקומות, Maps JavaScript API	שירות אינטרנט
Place.Field.CURRENT_OPENING_HOURS Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER*     * צריך להשתמש במקום Place.Field.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.USER_RATINGS_TOTAL, שהוצא משימוש. Place.Field.WEBSITE_URI	GMSPlacePropertyCurrentOpeningHours GMSPlacePropertySecondaryOpeningHours GMSPlacePropertyPhoneNumber GMSPlacePropertyPriceLevel GMSPlacePropertyRating GMSPlacePropertyOpeningHours GMSPlacePropertyUserRatingsTotal GMSPlacePropertyWebsite	internationalPhoneNumber nationalPhoneNumber priceLevel rating regularOpeningHours userRatingCount websiteUri	currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours transitStation userRatingCount websiteUri

שדות טריגר של Places Enterprise + Atmosphere

Android SDK	iOS SDK	ספריית מקומות, Maps JavaScript API	שירות אינטרנט
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	GMSPlacePropertyCurbsidePickup GMSPlacePropertyDelivery GMSPlacePropertyDineIn GMSPlacePropertyEditorialSummary GMSPlacePropertyReservable GMSPlacePropertyReviews GMSPlacePropertyServesBeer GMSPlacePropertyServesBreakfast GMSPlacePropertyServesBrunch GMSPlacePropertyServesDinner GMSPlacePropertyServesLunch GMSPlacePropertyServesVegetarianFood GMSPlacePropertyServesWine GMSPlacePropertyTakeout	allowsDogs editorialSummary evChargeOptions fuelOptions hasCurbsidePickup hasDelivery hasDineIn hasLiveMusic hasMenuForChildren hasOutdoorSeating hasRestroom hasTakeout hasWifi isGoodForChildren isGoodForGroups isGoodForWatchingSports isReservable parkingOptions paymentOptions reviews servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine	allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeAmenitySummary evChargeOptions fuelOptions generativeSummary goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren neighborhoodSummary parkingOptions paymentOptions outdoorSeating reservable restroom reviews reviewSummary routingSummaries^* servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout ^* חיפוש טקסט וחיפוש בסביבה בלבד

מק"ט: Address Validation Enterprise

	קטגוריה	Enterprise
	מזהה המק"ט	‫10F3-119A-C6EC (כל העולם) D73D-9896-24CF (הודו)
	ממשקי API	Address Validation API
	אירוע לחיוב	סשן שמסתיים בבקשה לאימות כתובת
	טריגרים	סשן של השלמה אוטומטית (חדשה) שמסתיים ב-ValidateAddress (REST). סשן של השלמה אוטומטית (חדש) שמסתיים ב-ValidateAddress (gRPC).
	תמחור	מחירון (גלובלי) מחירון (הודו)

למידע נוסף על התמחור ועל השימוש בסשנים של השלמה אוטומטית (חדשה) עם Places API, עיינו במדריכים הבאים במאמרי העזרה של ה-API של Places API:

• טוקנים לסשנים
• שימוש בטוקנים לסשנים
• thought השלמה אוטומטית (חדש) ותמחור לפי סשן

( חזרה לראש הדף )

מק"ט: Places API חיפוש בסביבה Enterprise

	קטגוריה	Enterprise
	מזהה המק"ט	‫772E-9975-BE34 (כל העולם) B049-A814-B2A8 (הודו)
	ממשקי API	חיפוש בסביבה (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות של Enterprise
	טריגרים	המק"ט הזה מופעל כשהבקשה כוללת אחד משדות הטריגר של Places Enterprise (ל-Android SDK, ל-iOS SDK, לספריית המקומות ב-Maps JavaScript API או לשירות אינטרנט).
	חיוב לפי מסכת שדות	החיוב מתבצע לפי תעריף המק"ט הגבוה ביותר מבין השדות המבוקשים. חיוב על מסכת שדות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API חיפוש בסביבה Enterprise + Atmosphere

	קטגוריה	Enterprise
	מזהה המק"ט	‫F20E-7034-0EF7 (כל העולם) 1DC0-87A6-65E7 (הודו)
	ממשקי API	חיפוש בסביבה (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות אווירה
	טריגרים	המק"ט הזה מופעל כשהבקשה כוללת אחד משדות הטריגר של Places Enterprise + Atmosphere (ל-Android SDK, ל-iOS SDK, לספריית המקומות ב-Maps JavaScript API או לשירות אינטרנט).
	חיוב לפי מסכת שדות	החיוב מתבצע לפי תעריף המק"ט הגבוה ביותר מבין השדות המבוקשים. חיוב על מסכת שדות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API Place Details Enterprise

	קטגוריה	Enterprise
	מזהה המק"ט	‫2D9A-3DE0-3766 (כל העולם) 448A-2967-E6BF (הודו)
	ממשקי API	פרטי מקומות ב-Places API
	אירוע לחיוב	בקשה מוצלחת לשדות של Enterprise
	טריגרים	המק"ט הזה מופעל כשהבקשה כוללת אחד משדות הטריגר של Places Enterprise (ל-Android SDK, ל-iOS SDK, לספריית המקומות ב-Maps JavaScript API או לשירות אינטרנט). אם מסיימים סשן של השלמה אוטומטית בקריאה ל-Place Details שמבקשת שדה כלשהו מהמק"ט SKU: Place Details Pro, Enterprise, או Enterprise + Atmosphere, הקריאה מחויבת לפי SKU: Place Details Enterprise + Atmosphere.
	חיוב לפי מסכת שדות	החיוב מתבצע לפי תעריף המק"ט הגבוה ביותר מבין השדות המבוקשים. חיוב על מסכת שדות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

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

	קטגוריה	Enterprise
	מזהה המק"ט	‫EB23-5ECC-F753 (כל העולם) ‫586E-FEBE-4FD2 (הודו)
	ממשקי API	פרטי מקומות ב-Places API
	אירוע לחיוב	בקשה מוצלחת לשדות Enterprise + Atmosphere
	טריגרים	בקשות שכוללות את אחד מהשדות של Places Enterprise + Atmosphere מפעילות את המק"ט הזה: שדות ל-Android SDK שדות ל-iOS SDK שדות של ספריית המקומות, Maps JavaScript API שדות לשירות אינטרנט אם מסיימים סשן של השלמה אוטומטית בקריאה ל-Place Details שמבקשת שדה כלשהו מהמק"טים SKU: Place Details Pro,‏ Enterprise או Enterprise + Atmosphere, הקריאה מחויבת לפי המק"ט SKU: Place Details Enterprise + Atmosphere.
	חיוב לפי מסכת שדות	כשמציינים מסכת שדה, הבקשה מחויבת לפי המק"ט הגבוה ביותר שרלוונטי לשדות המבוקשים. בקטע חיוב על מסכת שדות מפורטים פרטים, דוגמאות ומדריכים לשדות נתונים בפלטפורמה.
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API Place Details Photos

	קטגוריה	Enterprise
	מזהה המק"ט	‫DCD1-FE97-8C71 (כל העולם) 0AF7-8463-1BC9 (הודו)
	ממשקי API	תמונות של מקומות (חדש)
	אירוע לחיוב	בקשה מוצלחת לתמונה
	טריגרים	בקשה אל Place Photos (New)
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API חיפוש טקסט Enterprise

	קטגוריה	Enterprise
	מזהה המק"ט	E967-44BC-B44D (כל העולם) D112-1B19-2E0B (הודו)
	ממשקי API	חיפוש טקסט (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות של Enterprise
	טריגרים	המק"ט הזה מופעל כשהבקשה כוללת אחד משדות הטריגר של Places Enterprise (ל-Android SDK, ל-iOS SDK, לספריית המקומות ב-Maps JavaScript API או לשירות אינטרנט).
	חיוב לפי מסכת שדות	החיוב מתבצע לפי תעריף המק"ט הגבוה ביותר מבין השדות המבוקשים. חיוב על מסכת שדות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

מק"ט: Places API חיפוש טקסט Enterprise + Atmosphere

	קטגוריה	Enterprise
	מזהה המק"ט	‫120C-BEC3-B48F (גלובלי) 0FD0-B42B-DFDA (הודו)
	ממשקי API	חיפוש טקסט (חדש)
	אירוע לחיוב	בקשה מוצלחת לשדות Enterprise + Atmosphere
	טריגרים	המק"ט הזה מופעל כשהבקשה כוללת אחד משדות הטריגר של Places Enterprise + Atmosphere (ל-Android SDK, ל-iOS SDK, לספריית המקומות ב-Maps JavaScript API או לשירות אינטרנט).
	חיוב לפי מסכת שדות	החיוב מתבצע לפי תעריף המק"ט הגבוה ביותר מבין השדות המבוקשים. חיוב על מסכת שדות
	תמחור	מחירון (גלובלי) מחירון (הודו)

( חזרה לראש הדף )

דפי פרטים של מק"טים קשורים

• סקירה כללית של פרטי השימוש ב-API: ספריית מק"טים מלאה שמסודרת לפי רמות Essentials,‏ Pro,‏ Enterprise ו-Legacy.
• ‫Maps SKU details: מק"טים של Maps SDK ל-Android, ‏SDK של מפות ל-iOS, ‏Maps JavaScript API, ‏Maps Embed API, ‏Maps Static API, ‏Street View Static API, ‏Elevation API, ‏Aerial View API ו-Map Tiles API.
• פרטי המק"טים של Routes: מק"טים של Routes API,‏ Route Optimization API,‏ Roads API ו-Navigation SDK.
• פרטי מק"טים של סביבה: מק"טים של Air Quality API,‏ Pollen API,‏ Solar API ו-Weather API.
• פרטי המק"טים הקודמים של Places ו-Routes: מק"טים קודמים של Places API,‏ Directions API ו-Distance Matrix API.
• התמחור ב-Google Maps Platform והתמחור בהודו: רמות נפח חודשיות ותעריפים לכל אירוע.