פרטי המק"טים של הפלטפורמה של מפות Google

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

שמות מק"טים

בקטע הזה מפורטים כל המק"טים, שמחולקים ל-Essentials,‏ Pro ו-Enterprise.

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

הסבר על קטגוריות התמחור זמין בקטע הקטגוריות Essentials,‏ Pro ו-Enterprise במדריך סקירה כללית על חיוב.

בסיסיות

מפות מסלולים מקומות סביבה

מפות דינמיות

הטמעה1

Maps SDK2

מפות סטטיות

Street View סטטי

מטא-נתונים סטטיים של Street View

Map Tiles API: משבצות מפה דו-ממדיות

Map Tiles API: משבצות של Street View

Routes: Compute Routes Essentials

מסלולים: יסודות של מטריצת המסלולים ב-Compute

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

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

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

מיקום גיאוגרפי

Places API Place Details Essentials (מזהי מקומות בלבד)

העיקריים של פרטי המקומות ב-Places API

הנחיות בסיסיות לחיפוש טקסט ב-Places API (מזהים בלבד)

אזור זמן

שימוש בנתוני איכות האוויר

Solar API Building Insights

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

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

Pro

מפות מסלולים מקומות סביבה

תצוגה ממעוף גבוה

Street View דינמי

גובה

כבישים – הכביש הקרוב ביותר

כבישים – המסלול שנסעתם

דרכים – מגבלות מהירות

RouteOptimization - SingleVehicleRouting

Routes: ‏ Compute Routes Pro

Routes: ‏ Compute Route Matrix Pro

Address Validation Pro

Places API Nearby Search Pro

Places API Place Details Pro

Places API Text Search Pro

שימוש בנתוני אבקנים

ארגונים

מפות מסלולים מקומות סביבה

Map Tiles API: קטעי מפה ריאליסטיים בתלת-ממד

RouteOptimization – FleetRouting

Routes: Compute Routes Enterprise

Routes: Compute Route Matrix Enterprise

בקשת ניווט

Address Validation Enterprise

Places API Nearby Search Enterprise

Places API Nearby Search Enterprise + Atmosphere

Places API Place Details Enterprise

Places API Place Details Enterprise + Atmosphere

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

Places API Text Search Enterprise

Places API Text Search Enterprise + Atmosphere

שכבות נתונים של Solar API

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

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

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

מק"טים של מוצרים במפות Google

[ Essentials: מפות ]

מק"ט: מפות דינמיות

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

  קטגוריה Essentials
  אירוע לחיוב טעינת המפה
  טריגרים

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

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: הטמעה

המק"ט הזה מחויב על בקשות ל-Embed API.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל על בקשות ל-Embed API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Maps SDK

המק"ט הזה מחויב על טעינת מפה של אובייקט במפות Google, שלא נטען עם מזהה מפה, באפליקציה לנייד ל-Android או ל-iOS.

  קטגוריה Essentials
  אירוע לחיוב טעינת המפה
  טריגרים כל מופע של אובייקט מפה של Google, שלא נטען עם מזהה מפה, באפליקציה לנייד של Maps SDK for Android או של Maps SDK for iOS:

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Static Maps

המק"ט הזה מחויב על בקשות ל-Maps Static API.

  קטגוריה Essentials
  אירוע לחיוב טעינת המפה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-Maps Static API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Street View סטטי

המק"ט הזה מחויב על בקשות ל-Street View Static API שמחזירות תמונה פנורמית סטטית של Street View.

  קטגוריה Essentials
  אירוע לחיוב פנורמה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה ל-Street View Static API שמחזירה תמונה פנורמית סטטית של Street View.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Static Street View Metadata

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה ל-Street View Static API שמחזירה רק מטא-נתונים של תמונות. מידע נוסף זמין במאמר מטא-נתונים של תמונות Street View.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Pro: מפות ]

מק"ט: Aerial View

המק"ט הזה מחויב על בקשות לחיפוש טקסט ל-Aerial View API שמחזירות כתובת URL של סרטון אווירי.

  קטגוריה Pro
  אירוע לחיוב הבקשה ל-lookupVideo הושלמה
  טריגרים

מתבצעת חיוב על בקשות מוצלחות ל- lookupVideo שמחזירות כתובות URL.

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Dynamic Street View

המק"ט הזה מחויב על בקשות ל-Street View Static API שמחזירות תמונה פנורמית דינמית של Street View.

  קטגוריה Pro
  אירוע לחיוב פנורמה
  טריגרים

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

מק"ט: Elevation

המק"ט הזה מחויב על בקשות לשירות הגובה של Maps JavaScript API או ל-Elevation API.

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל על בקשות לשירותים הבאים:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מפות – משבצות דו-ממדיות ומשבצות של Street View

[ יסודות: Map Tiles ]

מק"ט: Map Tiles API: 2D Map Tiles

המק"ט הזה מחויב על בקשות ל-Map Tiles API לקבלת משבצות מפה דו-ממדיות.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-Map Tiles API שמאחזרת אחת מהשבבים הבאים של מפה דו-ממדית:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Map Tiles API: Street View Tiles

המק"ט הזה מחויב על בקשות ל-Map Tiles API לאחזור משבצות של Street View.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה לאחזור של אחד או יותר מהשבבים הבאים של Street View:
  • משבצות ב-Street View
  • תמונות ממוזערות של Street View
  • מזהי פנורמה של Street View
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מפות Google – קטעי מפה בתלת-מימד

[ Enterprise: Maps Tiles ]

מק"ט: Map Tiles API: Photorealistic 3D Tiles

המק"ט הזה מחויב על בקשות ל-Map Tiles API שמאחזרות משבצות Root תלת-ממדיות.

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-Map Tiles API שמאחזרת משבצות Root תלת-ממדיות.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

ניתוב מק"טים של מוצרים

[ Essentials: Routes ]

מק"ט: Routes: Compute Routes Essentials

המק"ט הזה מחויב על בקשות ל-Compute Routes.

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

מק"ט: Routes: Compute Route Matrix Essentials

המק"ט הזה מחויב על בקשות ל-Compute Route Matrix שמשתמשות בתכונות Essentials.

  קטגוריה Essentials
  אירוע לחיוב רכיב
  טריגרים המק"ט הזה מופעל לכל רכיב שמוחזר כששולחים בקשה ל-Compute Route Matrix שלא משתמשת בתכונות Pro או Enterprise.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Pro: כבישים ומסלולים ]

מק"ט: כבישים – הכביש הקרוב ביותר

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-שירות Nearest Roads ב-Roads API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: כבישים – המסלול שנסע

המק"ט הזה מחויב על בקשות ל-Roads API של השירות 'להיצמד לכבישים'.

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-שירות Snap to Roads ב-Roads API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: כבישים – מגבלות מהירות

המק"ט הזה עם גישה מוגבלת מחויב על בקשות ל-Roads API לשירות המגבלות המהירות.

  קטגוריה Pro1
  אירוע לחיוב רכיבים שמוחזרים בתגובת ה-API.
  טריגרים

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו
1 למק"ט הזה יש גישה מוגבלת.

מק"ט: Route Optimization: Single Vehicle Routing

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

  קטגוריה Pro
  אירוע לחיוב משלוח
  טריגרים

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

לא נחייב אותך על המשלוחים הבאים:

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

אם יש לכם בקשה לאופטימיזציית מסלולים עם הפרטים הבאים:

  • רכב אחד
  • 10 משלוחים ייחודיים (עם 10 מיקומי משלוחים או עומסי משלוחים ייחודיים)

החיוב מופעל על 10 המשלוחים שמופיעים במק"ט של ניתוב לרכב יחיד. במקום זאת, אותה בקשה עם 5 כלי רכב תגרום לחיוב במסגרת המק"ט Route Optimization: Fleet Routing.

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Routes: Compute Routes Pro

המק"ט הזה מחויב על בקשות ל-Compute Routes שמשתמשות בתכונות Pro.

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה ל-Compute Routes שמשתמשת באחת או יותר מהתכונות הבאות של Pro:

  • בין 11 ל-25 נקודות דרך ביניים
  • אופטימיזציה של נקודות ציון: ההגדרה שמפעילה את התכונה היא "optimizeWaypointOrder": "true".
  • ניתוח מצב התנועה או ניתוח מצב התנועה לצורך בחירת מסלול אופטימלי. אפשרויות הניתוב האלה תואמות להגדרת המאפיין routingPreference בבקשה לערך TRAFFIC_AWARE או לערך TRAFFIC_AWARE_OPTIMAL.
  • גורמים מתאימים למיקום כשמשתמשים באפשרויות הבאות כדי לציין איך נהגים צריכים להגיע למיקום מסוים:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Routes: Compute Route Matrix Pro

המק"ט הזה מחויב על בקשות ל-Compute Route Matrix שמשתמשות בתכונות Pro.

  קטגוריה Pro
  אירוע לחיוב רכיב
  טריגרים

המק"ט הזה מופעל לכל רכיב שמוחזר כששולחים בקשה שמשתמשת באחת או יותר מהתכונות הבאות של Pro:

  • ניתוח מצב התנועה או ניתוח מצב התנועה לצורך בחירת מסלול אופטימלי. אפשרויות הניתוב האלה תואמות להגדרת המאפיין routingPreference בבקשה לערך TRAFFIC_AWARE או לערך TRAFFIC_AWARE_OPTIMAL.
  • גורמים מתאימים למיקום כשמשתמשים באפשרויות הבאות כדי לציין איך נהגים צריכים להגיע למיקום מסוים:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Enterprise: Route Optimization, Routes ]

מק"ט: Route Optimization: Fleet Routing

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

  קטגוריה Enterprise
  אירוע לחיוב משלוח
  טריגרים המק"ט הזה מופעל לכל משלוח שמוחזר מבקשה ל- Route Optimization API שמציינת יותר מרכב אחד.

לא נחייב אותך על המשלוחים הבאים:

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

אם יש לכם בקשה לאופטימיזציית מסלולים עם הפרטים הבאים:

  • 5 כלי רכב
  • 10 משלוחים ייחודיים (עם 10 מיקומי משלוחים או עומסי משלוחים ייחודיים)

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Routes: Compute Routes Enterprise

המק"ט הזה מחויב על בקשות ל-Compute Routes שמשתמשות בתכונות Enterprise.

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה ל-Compute Routes שמשתמשת באחת או יותר מהתכונות הבאות של Enterprise:

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Routes: Compute Route Matrix Enterprise

המק"ט הזה מחויב על בקשות ל-Compute Route Matrix שמשתמשות בתכונות Enterprise.

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

[ Enterprise: Navigation ]

ערכות Navigation SDK כוללות את: Navigation SDK ל-Android ו-Navigation SDK ל-iOS.

המק"ט הזה מחויב על יעדים שנשלחו באמצעות Navigation SDK. חשוב לזכור שקריאה ל-method אחת יכולה להכיל עד 25 יעדים.

  קטגוריה Enterprise
  אירוע לחיוב יעד
  טריגרים

המק"ט הזה מופעל לכל יעד שנבקש באמצעות השיטות הבאות של Navigation SDK:

Android SDK

iOS SDK
  דוגמאות

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

חשוב לזכור שקריאה ל-method אחת יכולה להכיל עד 25 יעדים.

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"טים של מוצרים מסוג 'מקומות' (חדש)

[Essentials: מקומות, המרת כתובות לקואורדינטות (geocoding), מיקום גיאוגרפי ]

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל בתנאים הבאים:

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

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

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

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

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

המק"ט הזה מחויב על בקשות לשירות המרת כתובות לקואורדינטות (geocoding) של Maps JavaScript API או ל-Geocoding API.

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

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

המק"ט הזה מחויב על בקשות ל-Geolocation API.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כשמתבצעת בקשה למיקום גיאוגרפי מ-Geolocation API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

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

שדות ל-Android SDK

Place.Field.DISPLAY_NAME*
    * משתמשים במקום Place.Field.NAME (התכונה הוצאה משימוש בגרסה 4.0).
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME*
    * מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID.
     אפשר להשתמש ב-DISPLAY_NAME כדי לגשת לשם הטקסט של המקום.

שדות ל-iOS

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

שדות בספריית המקומות, Maps JavaScript API

id
photos

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

attributions
id
name*
photos

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

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

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

מק"ט: Places API Place Details Essentials

המק"ט הזה מחויב על בקשות ל-Place Details API שמאחזרות את השדות שבמק"ט הזה.
  קטגוריה 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
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport

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

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

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

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

המק"ט הזה מחויב על בקשות ל-Text Search API שמחזירות רק מזהי מסמכים.
  קטגוריה Essentials
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים

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

שדות ל-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
GMSPlacePropertyName

שדות בספריית המקומות, Maps JavaScript API

id

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

places.attributions
places.id
places.name*
nextPageToken

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

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

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

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

המק"ט הזה מחויב על בקשות ל-Time Zone API.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה ל-Time Zone API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ יתרון: אימות כתובת, מיקומים ]

מק"ט: Address Validation Pro

המק"ט הזה מחויב על בקשה לאימות כתובת מ-Address Validation API.

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל על ידי בקשה לאחת מהשיטות הבאות של Address Validation API:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Places API Nearby Search Pro

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

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

שדות ל-Android SDK

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

שדות ל-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.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 Place Details Pro

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

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

שדות ל-Android SDK

Place.Field.ACCESSIBILITY_OPTIONS*
    * משתמשים במקום Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (הוצא משימוש).
Place.Field.BUSINESS_STATUS
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
types
utcOffsetMinutes

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

accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* השדה googleMapsLinks נמצא בשלב של תצוגה מקדימה לפני GA, ואין חיוב, כלומר החיוב הוא 0 $על השימוש במהלך התצוגה המקדימה.

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

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

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

מק"ט: Places API Text Search Pro

המק"ט הזה הוא מק"ט נתונים שמשמש לחיוב על שדות שציינתם בבקשה ל-Text Search Pro.
  קטגוריה 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
GMSPlacePropertyFormattedAddress
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyCoordinate
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.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 טבלת התמחור הראשית
טבלת התמחור בהודו

[ Enterprise: Address Validation, Places ]

מק"ט: Address Validation Enterprise

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

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים סשנים שמשתמשים בהשלמה אוטומטית (חדש) ומסתיימים בבקשה לאחת מהשיטות הבאות של Address Validation API:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

מק"ט: Places API Nearby Search Enterprise

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

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

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

שדות ל-Android SDK

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

שדות ל-iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

שדות בספריית המקומות, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

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

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
  אירוע לחיוב בקשה
  טריגרים

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

שדות ל-Android SDK

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

שדות ל-iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

שדות בספריית המקומות, Maps JavaScript API

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

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

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 Place Details Enterprise

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

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

שדות ל-Android SDK

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

שדות בספריית המקומות, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

שדות ל-iOS

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

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

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
  אירוע לחיוב בקשה
  טריגרים

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

שדות ל-Android SDK

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

שדות ל-iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

שדות בספריית המקומות, Maps JavaScript API

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

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

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

מק"ט: Place Details Photos

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

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

מק"ט: Places API Text Search Enterprise

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

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

שדות ל-Android SDK

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

שדות ל-iOS SDK

GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite

שדות בספריית המקומות, Maps JavaScript API

internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

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

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

שדות ל-Android SDK

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

שדות ל-iOS SDK

GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout

שדות בספריית המקומות, Maps JavaScript API

allowsDogs
editorialSummary
evChargeOptions
fuelOptions
hasCurbsidePickup
hasDelivery
hasDineIn
hasLiveMusic
hasMenuForChildren
hasOutdoorSeating
hasRestroom
hasTakeout
hasWifi
isGoodForChildren
isGoodForGroups
isGoodForWatchingSports
isReservable
parkingOptions
paymentOptions
priceLevel
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

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

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

מק"טים של מוצרים בסביבה

[ Essentials: Environment ]

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

המק"ט הזה מחויב על בקשות ל-Air Quality API.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

החיוב מופעל עבור נקודות הקצה והשיטות הבאות:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Solar API Building Insights

המק"ט הזה מחויב על בקשות למשאב buildingInsights ב-Solar API.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה למשאב buildingInsights ב-Solar API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Pro: Environment ]

מק"ט: שימוש ב-Pollen

החיוב הזה מיועד לבקשות לנתוני אבקנים מ-Pollen API.

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

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

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

[ Enterprise: Environment ]

מק"ט: שכבות נתונים של Solar API

המק"ט הזה מחויב על בקשות למשאב dataLayers ב-Solar API.

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים

המק"ט הזה מופעל כששולחים בקשה למשאב dataLayers של Solar API.

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

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

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

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

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

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

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

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

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

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

[ Essentials: Places Legacy ]

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

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

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל עבור:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  קטגוריה Essentials
  אירוע לחיוב סשן
  טריגרים המק"ט השלמה אוטומטית (כולל פרטי מקום) – לכל סשן מחויב על סשן השלמה אוטומטית שמבקש פרטי מקום. באופן ספציפי:
  • Android: קריאה ל-fetchPlace()
  • iOS: קריאה ל-fetchPlaceFromPlaceID:
  • שירות אינטרנט: בקשה לקבלת פרטי מקום

השדות בבקשה:

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

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

אם מבקשים רק רענון של מזהה פרטי המקום (הבקשה כוללת רק את השדה 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 טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

אפשר ליצור סשנים של השלמה אוטומטית מהממשקי ה-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 טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

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

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

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

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

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

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ יתרון: Places מהדור הקודם ]

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

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

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

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

  • השלמה אוטומטית ללא פרטי מקום – לכל סשן
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Find Current Place

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מחויב על בקשות לשיטות הבאות:

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

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

שולחים בקשה לחיפוש המיקום הנוכחי באמצעות השדה ADDRESS בלבד:

החשבונית כוללת את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • נתונים בסיסיים

שולחים בקשה לחיפוש המיקום הנוכחי באמצעות השדה PHONE_NUMBER בלבד:

החשבונית כוללת את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • פרטי איש קשר

שולחים בקשה ל'חיפוש המיקום הנוכחי' עם כל שלושת השדות של סוגי הנתונים:

החשבונית כוללת את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • נתונים בסיסיים
  • פרטי איש קשר
  • נתוני אטמוספרה
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מחויב על בקשות לשיטות הבאות:
  • חיפוש המקום הנוכחי

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

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

שולחים בקשה לחיפוש מקום עם השדה ADDRESS בלבד:

החיובים שלך כוללים את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • נתונים בסיסיים

שולחים בקשה לחיפוש מקום עם השדה PHONE_NUMBER בלבד:

החשבונית כוללת את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • פרטי איש קשר

שולחים בקשה לחיפוש מקום עם כל שלושת השדות של סוגי הנתונים:

החשבונית כוללת את המק"טים הבאים:

  • חיפוש המקום הנוכחי
  • נתונים בסיסיים
  • פרטי איש קשר
  • נתוני אטמוספרה
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה לחיפוש בקרבת מקום באמצעות אחד מה-API הבאים:

הבקשה הזו לא תומכת בציינה של השדות להחזרה. התגובה מחזירה רשימה של מקומות וקבוצת משנה של שדות הנתונים הנתמכים.

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

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

  • מקום
  • נתונים בסיסיים
  • פרטי איש קשר
  • נתוני אטמוספרה
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל על בקשות לשירותים הבאים:

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

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

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

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

  • מקום – חיפוש טקסט
  • נתונים בסיסיים
  • פרטי איש קשר
  • נתוני אטמוספרה
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Place Details Pro

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל על בקשות מממשקי ה-API הבאים:

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

המק"ט הזה מפעיל גם חיוב על מק"טים של נתונים: אם תכללו שדות נתונים בבקשה, היא עשויה להפעיל חיוב נוסף על מק"טים של נתונים: Basic,‏ Contact ו-Atmosphere. כדי להימנע מעלויות מיותרות, עליכם לציין רק את שדות הנתונים הרלוונטיים. אתם מחויבים על המק"ט הזה וגם על הנתונים שאתם מבקשים.
  דוגמאות
  1. מבצעים את אחת מהפעולות הבאות:
    • נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה ADDRESS
    • Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת: getPlaceDetails(fields: formatted_address)
    המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
    • פרטי מקומות
    • נתונים בסיסיים
  2. מבצעים את אחת מהפעולות הבאות:
    • נייד: קוראים לפונקציה fetchPlace() ב-Android או fetchPlaceFromPlaceID: ב-iOS, ומציינים רק את השדה PHONE_NUMBER
    • שירות או ממשק API לאינטרנט: שולחים בקשה לקבלת פרטי מקום ומציינים את השדה של מספר הטלפון: getPlaceDetails(fields: formatted_phone_number)
    המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
    • פרטי מקומות
    • פרטי איש קשר
  3. מבצעים את אחת מהפעולות הבאות:
    • נייד: מחייגים למספר fetchPlace() ב-Android או למספר fetchPlaceFromPlaceID: ב-iOS ומציינים את כל השדות
    • Web API או שירות: שולחים בקשה לפרטים של מקום ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות): getPlaceDetails().
    המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
    • פרטי מקומות
    • נתונים בסיסיים
    • פרטי איש קשר
    • נתוני אטמוספרה
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Enterprise: Places Legacy ]

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

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

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

שדות ל-Android SDK

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, שהוצא משימוש

שדות ל-iOS SDK

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

שדות בספריית המקומות, Maps JavaScript API

מידע נוסף זמין במאמר שדות (פרטי המקום)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total.

  דוגמאות לחיוב באמצעות מסכת שדה

החיוב על הבקשה מתבצע על סמך השדות שצוינו במסכת השדות. לדוגמה:

  • אם מסכת השדות כוללת רק שדות מהמק"ט הזה: הבקשה מחויבת לפי התעריף של המק"ט הזה.
  • אם מסכת השדות כוללת שדות ממק"טים אחרים: הבקשה מחויבת לפי התעריף הגבוה ביותר של המק"ט עבור השדות המבוקשים. לדוגמה, אם תכללו שדות גם ממק"ט של 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 טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל עבור:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

[ Essentials: Routes Legacy ]

מק"ט: מסלול

המק"ט הזה מחויב על בקשה ל-Directions API, אלא אם הבקשה מפעילה את המק"ט לחיוב Directions Advanced. במקרה כזה, החיוב מתבצע לפי המק"ט הזה.

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

מק"ט: Distance Matrix

המק"ט הזה מחויב על הרכיבים שמוחזרים על ידי בקשה ל- Distance Matrix API (ממשק API מדור קודם) או ל- שירות מטריצת המרחקים של Maps JavaScript API, לא כולל בקשות שמפעילות את מק"ט החיוב של Distance Matrix Advanced.

  קטגוריה Essentials
  אירוע לחיוב רכיב
  טריגרים המק"ט הזה מופעל לכל רכיב שמוחזר על ידי בקשה ל-Distance Matrix API. כל שאילתה שנשלחת ל-Distance Matrix API יוצרת רכיבים, כאשר המספר של origins כפול המספר של destinations שווה למספר הרכיבים.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

[ Pro: Routes Legacy ]

מק"ט: Directions Advanced

המק"ט הזה מחויב על בקשה לשירות ההוראות של Maps JavaScript API או ל-Directions API (Legacy) שמשתמשת במידע על מצב התנועה, ביותר מ-10 נקודות ציון, באופטימיזציה של נקודות ציון או במודיפיקציות של מיקום.

  קטגוריה Pro
  אירוע לחיוב שאילתה
  טריגרים

המק"ט הזה מחויב על שירות הניווט של Maps JavaScript API או על בקשה ל-Directions API (Legacy) שמחזירה אחד או יותר מהפרטים הבאים:

  • מידע על מצב התנועה: כשמשתמשים בכל אפשרויות הבקשה הבאות כדי שהתגובה תחזיר את השדה duration_in_traffic:
    • מצב הנסיעה הוא 'נהיגה': מגדירים את הערך של mode ל-driving. Driving הוא אמצעי התחבורה שמוגדר כברירת מחדל.
    • Departure time is set: מציינים ערך חוקי בשדה departure_time. אפשר להגדיר את departure_time לשעה הנוכחית או למועד כלשהו בעתיד. הוא לא יכול להיות בעבר.
    • ללא נקודות עצירה: לא כוללים נקודות עצירה. אם הבקשה כוללת נקודות ציון, צריך להוסיף את התחילית via: לכל נקודת ציון כדי להשפיע על המסלול, אבל להימנע מעצירות ביניים. לדוגמה, 
      &waypoints=via:San Francisco|via:Mountain View|...
  • יותר מ-10 נקודות דרך: כשכוללים בין 11 ל-25 נקודות דרך.
  • אופטימיזציה של נקודות דרך: בבקשה, הפרמטר optimize מוגדר לערך true עבור נקודות דרך. לדוגמה, 
    &waypoints=optimize:true|San Francisco|Mountain View|...
  • משתני מיקום: כשמשתמשים במשתני המיקום הבאים כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
    • side_of_road
    • heading
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Distance Matrix Advanced

המק"ט הזה מחויב על הרכיבים שמוחזרים על ידי בקשה ל- Distance Matrix API (ממשק API מדור קודם) או ל- שירות מטריצת המרחקים של Maps JavaScript API שמשתמש במידע על תנועה ו/או במודיפיקציות של מיקום.

  קטגוריה Pro
  אירוע לחיוב רכיב
  טריגרים

המק"ט הזה מופעל לכל רכיב שמוחזר על ידי בקשה ל-Distance Matrix API. כל שאילתה שנשלחת ל-Distance Matrix API יוצרת רכיבים, כאשר המספר של origins כפול המספר של destinations שווה למספר הרכיבים.

מק"ט מתקדם של מטריצת מרחקים מחויב על שימוש ב- Distance Matrix API (ממשק API מדור קודם) או ב- שירות מטריצת מרחקים של Maps JavaScript API שמשתמש באחד או יותר מהרכיבים הבאים:

  • מידע על מצב התנועה כשמשתמשים בכל אפשרויות הבקשה הבאות כדי שהתגובה תחזיר את השדה duration_in_traffic בתשובה של מטריצת המרחק:
    • מצב הנסיעה הוא 'נהיגה': מגדירים את הערך של mode ל-driving. Driving הוא אמצעי התחבורה שמוגדר כברירת מחדל.
    • Departure time is set: מציינים ערך חוקי בשדה departure_time. אפשר להגדיר את departure_time לשעה הנוכחית או למועד כלשהו בעתיד. הוא לא יכול להיות בעבר.
  • גורמים מתאימים למיקום כשמשתמשים ב modifers הבאים של מיקום כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
    • side_of_road
    • heading
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו