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

בדף הזה מפורטים המק"טים, מזהי המק"טים, האירועים לחיוב והטריגרים לחיוב של המק"טים בגרסאות הקודמות של Places API,‏ Directions API ו-Distance Matrix API. בגרסאות הנוכחיות של השירותים האלה, אפשר לעיין בפרטי המק"טים של Places (חדש) ובפרטי המק"טים של מסלולים וניווט. בסקירה הכללית של פרטי השימוש ב-API מופיעה רשימה של כל קטגוריות המוצרים.

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

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

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

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

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

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

שלושת המק"טים של נתוני Places הם: Basic Data, Contact Data ו- Atmosphere Data.

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

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

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

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

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

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

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

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

[ Essentials: Places Legacy ]

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

	קטגוריה	Essentials
	מזהה המק"ט	‫7384-2DE4-D388 (כל העולם) 2164-BC00-53DC (הודו)
	ממשקי API	השלמה אוטומטית למקומות (גרסת קודמת) ב-Android, השלמה אוטומטית למקומות (גרסת קודמת) ב-iOS, השלמה אוטומטית למקומות (גרסת קודמת) באינטרנט
	אירוע לחיוב	בקשה שלא כוללת טוקן לסשן
	טריגרים	‫Android: findAutocompletePredictions() iOS: findAutocompletePredictionsFromQuery: JavaScript: שירות ההשלמה האוטומטית למקומות של Maps JavaScript API שירות אינטרנט: שירות ההשלמה האוטומטית למקומות של Places API
	דוגמאות	אם תשלחו בקשה מסשן השלמה אוטומטית לא חוקי (לדוגמה, סשן שמשתמש שוב באסימון סשן), תחויבו גם במק"ט Autocomplete – Per Request. יכול להיות שבקשות להשלמה אוטומטית מווידג'ט ההשלמה האוטומטית למקומות ב-Maps JavaScript API יחויבו במק"ט "השלמה אוטומטית – לכל בקשה" כששולחים בקשות מסשן לא תקין של השלמה אוטומטית. מצב כזה יכול לקרות כשמשתמש מקליד או מעתיק ומדביק כמה כתובות שונות בווידג'ט, ולא תמיד בוחר הצעה להשלמת החיפוש.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן

	קטגוריה	Essentials
	מזהה המק"ט	‫E9C9-934B-DDB1 (כל העולם)
	ממשקי API	השלמה אוטומטית למקומות (גרסת קודמת) ב-Android, השלמה אוטומטית למקומות (גרסת קודמת) ב-iOS, השלמה אוטומטית למקומות (גרסת קודמת) באינטרנט
	אירוע לחיוב	סשן
	טריגרים	Android: קריאה ל-fetchPlace() ‫iOS: קריאה ל-fetchPlaceFromPlaceID: שירות אינטרנט: בקשה לפרטי מקום השדות בבקשה: כדי להימנע מחיובים מיותרים, הקפידו לציין בבקשה את השדות שאתם צריכים. בהתאם לשדות שציינתם, בקשה של פרטי מקום יוצרת גם את המק"טים הבאים של נתונים: נתונים בסיסיים (Essentials) מקומות – פרטים ליצירת קשר (Enterprise) מקומות – אווירה (Enterprise) אם לא תציינו שדות בבקשה ל-Place Details, יופעלו כל המק"טים של הנתונים. אם אתם מבקשים רק רענון של מזהה פרטי המקום (הבקשה מציינת רק את השדה place_id) במהלך סשן של השלמה אוטומטית, הסשן מחויב לפי מק"ט: Autocomplete without Place Details – Per Session.
	דוגמאות	הערה: אפשר לראות את המק"ט הזה בדוחות החיוב, אבל לא בדף Billing > Pricing במסוף Google Cloud. בקשות להשלמה אוטומטית זמינות ללא תשלום. החיוב על המק"ט הקודם הזה מתבצע כשמבקשים Place Details נוספים, על סמך התמחור הרגיל של Place Details. בדוגמה הבאה מוצגת סדרה של בקשות לפי פלטפורמה, שיובילו למק"טים הבאים בחשבון, כשמציגים את החשבון לפי מק"ט: השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן פרטי מקומות נתונים בסיסיים דוגמה לבקשה לפי פלטפורמה: בקשות ב-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) בקשות לשירות אינטרנט בקשה להשלמה אוטומטית למקומות (קלט="par", טוקן לסשן: XYZ) בקשה להשלמה אוטומטית למקומות (קלט="paris", טוקן לסשן: XYZ) Place Details (מזהה מקום, טוקן לסשן: XYZ, fields:formatted_address)
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

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

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

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

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

הבקשות להשלמה אוטומטית והבקשות ל-Places Details שמשתמשות בסשנים מחויבות במק"טים שונים.

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

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

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

	קטגוריה	Essentials
	מזהה המק"ט	‫75D4-C522-326B (כל העולם) 5D7B-1F7B-395E (הודו)
	ממשקי API	Places Details (הגרסה הקודמת) עם שדות בסיסיים Find Place (הגרסה הקודמת) עם שדות בסיסיים
	אירוע לחיוב	בקשה מוצלחת לשדות של נתונים בסיסיים
	טריגרים	שדות ל-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 החיוב על המק"ט הזה הוא בנוסף למק"ט הבסיסי (Place Details,‏ חיפוש מקום,‏ חיפוש בסביבה או חיפוש טקסט) על הבקשה שהפעילה אותו.
	חיוב לפי מסכת שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי תעריף המק"ט הגבוה ביותר לשדות שהתבקשו. לדוגמה, אם תכללו שדות גם ממק"ט Essentials וגם ממק"ט Enterprise, הבקשה תחויב לפי התעריף של מק"ט Enterprise.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: Find Place – ID only

	קטגוריה	Essentials
	מזהה המק"ט	44A2-D839-A3AC (גלובלי) ‫FE05-60A4-CDDF (הודו)
	ממשקי API	שירות האינטרנט של Places – חיפוש מקום
	אירוע לחיוב	בקשה מוצלחת רק עבור place_id
	טריגרים	בקשת חיפוש מקום בלי שדות שצוינו, או רק עם השדה place_id: FindPlace(fields: place_id).
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: Place Details – ID Refresh

	קטגוריה	Essentials
	מזהה המק"ט	‫2D88-4302-6299 (כל העולם) 4604-F56B-7086 (הודו)
	ממשקי API	Place Details (Legacy)
	אירוע לחיוב	בקשה מוצלחת לשדות מזהים בלבד
	טריגרים	בקשה עם השדה מזהה מקום בלבד: getPlaceDetails(fields: place_id).
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Essentials
	מזהה המק"ט	‫C4B1-8805-63EF (כל העולם) 59E9-EB83-5CA3 (הודו)
	ממשקי API	שירות השלמה אוטומטית של שאילתות
	אירוע לחיוב	בקשה שהושלמה בהצלחה
	טריגרים	‫JavaScript: שירות ההשלמה האוטומטית למקומות ב-Maps JavaScript API (getQueryPredictions()) והשימוש ב ווידג'ט SearchBox של Maps JavaScript API (בקשות להשלמה אוטומטית של שאילתות נוצרות כשהמשתמש מקליד). שירות אינטרנט: שירות השלמה אוטומטית של שאילתות ב-Places API התמחור לפי סשן של השלמה אוטומטית לא נתמך כשמשתמשים ב-Query Autocomplete. בקשות Place Details הבאות מחויבות על סמך Place Details Pro SKU.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

[ Pro: Places Legacy ]

מק"ט: Autocomplete without Place Details – Per Session

	קטגוריה	Pro
	מזהה המק"ט	‫B52C-8320-6DC5 (גלובלי) C625-D3CE-DF37 (הודו)
	ממשקי API	השלמה אוטומטית למקומות (גרסת קודמת) ב-Android, השלמה אוטומטית למקומות (גרסת קודמת) ב-iOS, השלמה אוטומטית למקומות (גרסת קודמת) באינטרנט
	אירוע לחיוב	סשן
	טריגרים	Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) וגם findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) שלא מגיעה אחריהן בקשה לפרטי מקום. ‫iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... וגם placesClient?.findAutocompletePredictions(fromQuery: "paris" ... שלא אחריו בקשה של Place Details. שירות אינטרנט בקשה להשלמה אוטומטית למקומות (input="par", session_token: XYZ) וגם בקשה להשלמה אוטומטית למקומות (input="paris", session_token: XYZ) שלא מופיעה אחריה בקשה לפרטי מקום.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: חיפוש המיקום הנוכחי

	קטגוריה	Pro
	מזהה המק"ט	‫7218-264C-D1D7 (כל העולם) 0862-F46E-1A1A (הודו)
	ממשקי API	Places SDK ל-Android, Places SDK ל-iOS
	אירוע לחיוב	בקשה שהושלמה בהצלחה
	טריגרים	ה-method‏ findCurrentPlace() (Android) השיטה findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם כוללים שדות נתונים בבקשה, היא יכולה להפעיל חיוב נוסף על מק"טים של נתונים: Basic Data,‏ Contact Data ו-Atmosphere Data. כדי להימנע מעלויות מיותרות, ציינו רק את שדות הנתונים שאתם רוצים. החיוב הוא על המק"ט הזה וגם על הנתונים שביקשתם.
	דוגמאות	בדוגמאות הבאות מוסבר על אילו מק"טים תחויבו כשתשלחו בקשה מסוג Find Current Place ותציינו שדות ממק"טים של נתונים מסוג Basic,‏ Contact ו-Atmosphere. כדי לראות את המק"טים בחשבון, אתם יכולים להציג את החשבון לפי מק"ט, כמו שמתואר במאמר ניתוח השימוש והעלות לכל מק"ט. אתם שולחים בקשה לאיתור המיקום הנוכחי עם השדה ADDRESS בלבד: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתונים בסיסיים אתם שולחים בקשה לאיתור המיקום הנוכחי עם השדה PHONE_NUMBER בלבד: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתוני אנשי קשר אתם שולחים בקשה מסוג Find Current Place עם כל שלושת השדות של סוגי הנתונים: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתונים בסיסיים נתוני אנשי קשר נתוני אטמוספירה
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Pro
	מזהה המק"ט	‫DC67-3188-2294 (כל העולם) ECB4-087C-9A27 (הודו)
	ממשקי API	חיפוש מקום (גרסה קודמת)
	אירוע לחיוב	בקשה מוצלחת ליותר משדה המזהה בלבד
	טריגרים	בקשת חיפוש מקום שצוין בה יותר משדה המזהה בלבד. המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם כוללים שדות נתונים בבקשה, יכול להיות שיופעל חיוב נוסף על מק"טים של נתונים: Basic Data,‏ Contact Data ו-Atmosphere Data. כדי להימנע מעלויות מיותרות, ציינו רק את שדות הנתונים שאתם רוצים. החיוב הוא על המק"ט הזה וגם על הנתונים שביקשתם.
	דוגמאות	בדוגמאות הבאות מוסבר על אילו מק"טים תחויבו כשתשלחו בקשה מסוג Find Current Place ותציינו שדות ממק"טים של נתונים מסוג Basic,‏ Contact ו-Atmosphere. כדי לראות את המק"טים בחשבון, אתם יכולים להציג את החשבון לפי מק"ט, כמו שמתואר במאמר ניתוח השימוש והעלות לכל מק"ט. אתם שולחים בקשה לחיפוש מקום עם השדה ADDRESS בלבד: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתונים בסיסיים אתם שולחים בקשה לחיפוש מקום עם השדה PHONE_NUMBER בלבד: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתוני אנשי קשר אתם שולחים בקשת Find Place עם כל שלושת השדות של סוגי הנתונים: בחשבון שלכם מופיעים המק"טים הבאים: חיפוש המיקום הנוכחי נתונים בסיסיים נתוני אנשי קשר נתוני אטמוספירה
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Pro
	מזהה המק"ט	‫6B23-8A17-D29D (כל העולם) CC66-BE0E-2477 (הודו)
	ממשקי API	חיפוש בסביבה (גרסה קודמת)
	אירוע לחיוב	בקשה מוצלחת לתכונות Pro
	טריגרים	שירות החיפוש בסביבה של מקומות ב-Maps JavaScript API (nearbySearch()) שירות החיפוש בסביבה של Places API בבקשה הזו אי אפשר לציין אילו שדות יוחזרו. התגובה מחזירה רשימה של מקומות וקבוצת משנה של שדות הנתונים הנתמכים. ‫ המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: בקשה של חיפוש בסביבה (דור קודם) מחזירה את כל שדות הנתונים הזמינים של המקום שנבחר, ולכן היא יכולה להפעיל חיוב נוסף על מק"טים של נתונים: נתונים בסיסיים, פרטים ליצירת קשר ונתוני אווירה. החיוב הוא על המק"ט הזה וגם על הנתונים שביקשתם. כדי להימנע מבקשת נתונים שאתם לא צריכים (ומתשלום עליהם), השתמשו במקום זאת בבקשה מסוג חיפוש מקום (מדור קודם).
	דוגמאות	אתם שולחים בקשה לחיפוש בסביבה, למשל NearbySearch (San Francisco, 100 meters). המק"טים האלה מופיעים בחיוב כשאתם מציגים את החיוב לפי מק"ט: מקום נתונים בסיסיים נתוני אנשי קשר נתוני אטמוספירה
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Pro
	מזהה המק"ט	‫E95A-86C7-7F47 (כל העולם) 102E-888D-5596 (הודו)
	ממשקי API	חיפוש טקסט (גרסת קודמת)
	אירוע לחיוב	בקשה מוצלחת לחיפוש טקסט (גרסה קודמת)
	טריגרים	שירות חיפוש הטקסט של מקומות ב-Maps JavaScript API (textSearch()). שירות חיפוש הטקסט של Places API בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא תומכות בציון השדות שיוחזרו. בקשות של חיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על הבקשה של חיפוש הטקסט וגם על כל המק"טים של סוגי הנתונים: נתונים בסיסיים, נתוני קשר ו נתוני אווירה. ‫מק"ט: Places – חיפוש טקסט מופעל גם על ידי הווידג'ט Place SearchBox של Maps JavaScript API: השיטה getPlaces() אחרי שהמשתמש בוחר שאילתת מקום (סמל: זכוכית מגדלת), ולא תוצאה (סמל: סיכה), כמו שמוצג כאן: בתוצאות של ווידג'ט תיבת החיפוש, אחרי שמקלידים "פיצה" בתיבת החיפוש, שימו לב שליד משלוחי פיצה מופיע סמל של זכוכית מגדלת, שמציין שזו שאילתת מקום (ולא תוצאה). המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: בקשה של חיפוש טקסט (דור קודם) מחזירה את כל שדות הנתונים שזמינים למקום שנבחר, ולכן היא יכולה להפעיל חיוב נוסף על מק"טים של נתונים: נתונים בסיסיים, פרטים ליצירת קשר ונתוני אווירה. החיוב הוא על המק"ט הזה וגם על הנתונים שביקשתם. כדי להימנע מבקשת נתונים שאתם לא צריכים (ומתשלום עליהם), השתמשו במקום זאת בבקשה מסוג חיפוש מקום (מדור קודם).
	דוגמאות	אם שולחים בקשה לחיפוש טקסט (דור קודם), המק"טים האלה מופיעים בחשבון כשמציגים את החשבון לפי מק"ט: מקומות – חיפוש טקסט נתונים בסיסיים נתוני אנשי קשר נתוני אטמוספירה
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Pro
	מזהה המק"ט	‫FC5C-DF28-543F (כל העולם) F7AA-FEF9-C90E (הודו)
	ממשקי API	Place Details (Legacy)
	אירוע לחיוב	בקשה מוצלחת לתכונות Pro
	טריגרים	‫Android: Places SDK ל-Android (fetchPlace()) iOS: ‫Places SDK ל-iOS‏ (fetchPlaceFromPlaceID:) ‫JavaScript: שירות Place Details ב-Maps JavaScript API (getDetails) ‫JavaScript: ווידג'ט השלמה אוטומטית למקומות ב-Maps JavaScript API (getPlace) ‫JavaScript: הווידג'ט Place SearchBox ב-Maps JavaScript API: השיטה getPlaces() אחרי שהמשתמש בוחר תוצאת מקום (סמל: סיכה), *ולא* שאילתה (סמל: זכוכית מגדלת), כמו שמוצג כאן: בתוצאות של הווידג'ט של תיבת החיפוש, אחרי שמקלידים "פיצה" בתיבת החיפוש, שימו לב שליד פיצה אותנטיקו מופיע סמל של סיכה, שמציין שזו תוצאת מקום (ולא שאילתה). שירות אינטרנט: שירות Place Details (דור קודם) כשמשתמשים ב-API ובשירותים לאינטרנט, החיוב על המק"ט של פרטי המקום מתבצע גם אם מספקים טוקן לסשן וגם אם לא. המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם כוללים שדות נתונים בבקשה, יכול להיות שיופעל חיוב נוסף על מק"טים של נתונים: Basic Data,‏ Contact Data ו-Atmosphere Data. כדי להימנע מעלויות מיותרות, ציינו רק את שדות הנתונים שאתם רוצים. החיוב הוא על המק"ט הזה וגם על הנתונים שביקשתם.
	דוגמאות	מבצעים את אחת מהשיחות או הבקשות הבאות: בנייד: מפעילים את fetchPlace() ב-Android או את fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה ADDRESS. שירות או Web API: שולחים בקשה ל-Place Details (Legacy) ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address) בחשבון שלכם, המק"טים האלה יופיעו (כשמציגים את החשבון לפי מק"ט): פרטי המקום נתונים בסיסיים מבצעים את אחת מהשיחות או הבקשות הבאות: בנייד: מפעילים את fetchPlace() ב-Android או את fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה PHONE_NUMBER. שירות או Web API: שולחים בקשה לפרטי מקום (ממשק קודם) ומציינים את השדה של מספר הטלפון: getPlaceDetails(fields: formatted_phone_number) בחשבון שלכם, המק"טים האלה יופיעו (כשמציגים את החשבון לפי מק"ט): פרטי המקום נתוני אנשי קשר מבצעים את אחת מהשיחות או הבקשות הבאות: בנייד: מפעילים את fetchPlace() ב-Android או את fetchPlaceFromPlaceID: ב-iOS, ומציינים את כל השדות ממשק API או שירות לאינטרנט: שולחים בקשה לפרטי מקום (מדור קודם) ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות): getPlaceDetails(). בחשבון שלכם, המק"טים האלה יופיעו (כשמציגים את החשבון לפי מק"ט): פרטי המקום נתונים בסיסיים נתוני אנשי קשר נתוני אטמוספירה
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

‫[ Enterprise: Places Legacy ]

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

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

	קטגוריה	Enterprise
	מזהה המק"ט	‫D63D-5CC5-302A (כל העולם) 0CE0-1963-137E (הודו)
	ממשקי API	‫Places Details (הגרסה הקודמת) עם שדות אווירה ‫Find Place (הגרסה הקודמת) עם שדות אווירה
	אירוע לחיוב	בקשה מוצלחת לשדות נתונים של Atmosphere
	טריגרים	החיוב על המק"ט הזה הוא בנוסף למק"ט הבסיסי (Place Details,‏ חיפוש מקום,‏ חיפוש בסביבה או חיפוש טקסט) של הבקשה שהפעילה אותו.
	דוגמאות לחיוב על מסכת שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי תעריף המק"ט הגבוה ביותר לשדות שהתבקשו. לדוגמה, אם תכללו שדות גם ממק"ט Essentials וגם ממק"ט Enterprise, הבקשה תחויב לפי התעריף של מק"ט Enterprise.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

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

	קטגוריה	Enterprise
	מזהה המק"ט	F095-CD01-81B2 (גלובלי) A03F-5079-C66C (הודו)
	ממשקי API	פרטי מקומות (גרסה קודמת) עם שדות של פרטים ליצירת קשר חיפוש מקום (גרסה קודמת) עם שדות של פרטים ליצירת קשר
	אירוע לחיוב	בקשה מוצלחת לשדות נתונים של אנשי קשר
	טריגרים	שדות ל-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 החיוב על המק"ט הזה הוא בנוסף למק"ט הבסיסי (Place Details,‏ חיפוש מקום,‏ חיפוש בסביבה או חיפוש טקסט) על הבקשה שהפעילה אותו.
	חיוב לפי מסכת שדות	החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה: אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה. אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי תעריף המק"ט הגבוה ביותר לשדות שהתבקשו. לדוגמה, אם תכללו שדות גם ממק"ט Essentials וגם ממק"ט Enterprise, הבקשה תחויב לפי התעריף של מק"ט Enterprise.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

	קטגוריה	Enterprise
	מזהה המק"ט	‫81E7-85D0-58A7 (גלובלי) 9F4B-2E19-1B63 (הודו)
	ממשקי API	Places Photo (גרסה קודמת)
	אירוע לחיוב	בקשה מוצלחת לתמונה
	טריגרים	Android: בקשות אל fetchPhoto() ‫iOS: בקשות אל loadPlacePhoto: ‫JavaScript: בקשות אל PlacePhoto.getUrl() לטעינת נתונים של פיקסל תמונה. שירות אינטרנט: בקשות לשירות Place Photos של Places API.
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"טים של Routes API מדור קודם

[ Essentials: Routes Legacy ]

מק"ט: מסלול הגעה

	קטגוריה	Essentials
	מזהה המק"ט	‫28A8-3EB4-4595 (כל העולם) 4714-291C-3199 (הודו)
	ממשקי API	שירות המסלולים של Maps JavaScript API, Directions API (דור קודם)
	אירוע לחיוב	בקשה מוצלחת בלי תכונות של Pro או Enterprise
	טריגרים	שאילתות שלא מפעילות מק"ט עם דירוג גבוה יותר
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: מטריצת מרחקים

	קטגוריה	Essentials
	מזהה המק"ט	‫C1B6-FF9D-7700 (גלובלי) thought 558A-4F88-F361 (הודו)
	ממשקי API	‫ Distance Matrix API (דור קודם), שירות מטריצת מרחקים ב-Maps JavaScript API
	אירוע לחיוב	כל רכיב שלא מכיל תכונות של Pro או Enterprise. כל בקשה שנשלחת אל Distance Matrix API יוצרת רכיבים, כאשר מספר הorigins כפול מספר הdestinations שווה למספר הרכיבים.
	טריגרים	בקשות לאלמנטים שלא מפעילות מק"טים במחיר גבוה יותר
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

[ Pro: Routes Legacy ]

מק"ט: Directions Advanced

	קטגוריה	Pro
	מזהה המק"ט	‫9407-00C2-CF85 (כל העולם) E27B-BD57-FD7D (הודו)
	ממשקי API	שירות המסלולים של Maps JavaScript API, Directions API (דור קודם)
	אירוע לחיוב	בקשה מוצלחת עם תכונות Pro
	טריגרים	duration_in_traffic. בין 11 ל-25 נקודות ציון. מגדירים את waypoints=optimize:true. מגדירים את אחד ממגדירי המיקום הבאים: side_of_road heading
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

מק"ט: Distance Matrix Advanced

	קטגוריה	Pro
	מזהה המק"ט	‫DFAE-763F-CF6E (כל העולם) C0F4-32AE-F6D1 (הודו)
	ממשקי API	‫ Distance Matrix API (דור קודם), שירות מטריצת מרחקים ב-Maps JavaScript API
	אירוע לחיוב	כל רכיב שמוחזר עם תכונות Pro. כל בקשה שנשלחת אל Distance Matrix API יוצרת רכיבים, כאשר מספר הorigins כפול מספר הdestinations שווה למספר הרכיבים.
	טריגרים	duration_in_traffic. מגדירים את אחד מ מגדירי המיקום הבאים: side_of_road heading
	תמחור	מחירון (גלובלי) מחירון (הודו)

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

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

• סקירה כללית של פרטי השימוש ב-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.
• פרטי המק"טים של Places (חדש): מק"טים של Places API (חדש), Places UI Kit,‏ Places Aggregate API,‏ Address Validation API,‏ Geocoding API,‏ Geolocation API,‏ Time Zone API ו-Maps Grounding Lite.
• פרטי מק"טים של סביבה: מק"טים של Air Quality API,‏ Pollen API,‏ Solar API ו-Weather API.
• התמחור ב-Google Maps Platform והתמחור בהודו: רמות נפח חודשיות ותעריפים לכל אירוע.