פרטי השימוש ב-API של הפלטפורמה של מפות Google

בדף הזה מפורטים המק"טים של Google Maps Platform, כולל המק"טים להודו.

מק"ט (Stock Keeping Unit) הוא פריט ייחודי מ-Google Maps Platform שמשויך למוצר, ולמוצר יכולים להיות משויכים כמה מק"טים. כדי לראות את המחירים של המק"טים, אפשר לעיין במחירונים של מק"טים גלובליים ושל מק"טים בהודו.

שמות מק"טים

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

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

מידע נוסף על מק"טים של Essentials,‏ Pro ו-Enterprise זמין במאמר בנושא קטגוריות תמחור.

Essentials

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

מפות דינמיות

הטמעה1

Maps SDK2

מפות סטטיות

תמונות סטטיות של Street View

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

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

‫Map Tiles API: Street View Tiles

‫Routes: Compute Routes Essentials

Routes: Compute Route Matrix Essentials

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

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

Geocoding

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

Places API Place Details Essentials (IDs Only)

Places API Place Details Essentials

Places API Text Search Essentials (IDs Only)

Places UI Kit Query

Places UI Kit - השלמה אוטומטית לסשן

אזור זמן

‫Maps Grounding Lite

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

Solar API Building Insights

Weather Usage

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

‫2 Mobile Native Static Maps ו-Mobile Native Dynamic Maps מוזגו עכשיו למק"ט אחד: Maps SDK. לא בוצעו שינויים נוספים בשירותים האלה.

Pro

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

Aerial View

תמונות דינמיות של Street View

גובה

מפות תלת-ממדיות

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

Roads – מסלול הנסיעה

Roads - Speed Limits

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

‫Places Aggregate API

Pollen Usage

Enterprise

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

‫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 Place Details Photos

Places API Text Search Enterprise

Places API Text Search Enterprise + Atmosphere

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

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

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

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

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

‫[ Essentials: Maps ]

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫FAF4-3B2D-51B2 (כל העולם)

‫AA0F-63D7-9D0E (הודו)
  APIs ‫ Maps JavaScript API
  אירוע לחיוב הצגת המפה הושלמה
  טריגרים
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"ט: הטמעה

  קטגוריה ‫Essentials
  מזהה מק"ט

‫9C10-8313-F21F (כל העולם)

‫CFCA-F7C3-159C (הודו)
  APIs ‫Embed API
  אירוע לחיוב בקשה מוצלחת ל-Embed API
  טריגרים בקשות אל Embed API.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Maps SDK

  קטגוריה ‫Essentials
  מזהה מק"ט

‫6DE1-4D9C-5B67 (גלובלי)

‫A319-2357-D01E (הודו)
  APIs ‫SDK של מפות ל-Android
‫SDK של מפות ל-iOS
  אירוע לחיוב הצגה של מפה
  טריגרים

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

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫3C2D-B525-2E5F (כל העולם)

‫4D28-62E3-9F71 (הודו)
  APIs ‫Maps Static API
  אירוע לחיוב הצגה של מפה
  טריגרים בקשה להצגה של מפה בוצעה בהצלחה אל Maps Static API.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: תמונות סטטיות של Street View

  קטגוריה ‫Essentials
  מזהה מק"ט

‫9BD0-A2EE-44C3 (כל העולם)

‫C08C-647F-C33B (הודו)
  APIs ‫Street View Static API
  אירוע לחיוב טעינת פנורמה
  טריגרים

בקשה מוצלחת לתמונה פנורמית סטטית ב-Street View אל Street View Static API.
  הערות
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫3168-48A9-5C8C (כל העולם)

‫44B3-744C-0C2A (הודו)
  APIs ‫Street View Static API
  אירוע לחיוב בקשה מוצלחת למטא-נתונים בלבד
  טריגרים בקשה מוצלחת של מטא-נתונים בלבד אל Street View Static API. מידע נוסף מופיע במאמר בנושא מטא-נתונים של תמונות Street View.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Pro: Maps ]

מק"ט: Aerial View

  קטגוריה ‫Pro
  מזהה מק"ט

‫C9F8-981F-CF51 (כל העולם)

‫1AD4-6C97-00E8 (הודו)
  APIs Aerial View API
  אירוע לחיוב בקשה מוצלחת לנתוני Pro
  טריגרים

‫lookupVideo.

  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: תצוגה דינמית של Street View

  קטגוריה ‫Pro
  מזהה מק"ט

‫658E-F885-E11A (כל העולם)

‫6E5F-B76B-11ED (הודו)
  APIs ‫Maps JavaScript API
  אירוע לחיוב טעינת פנורמה מוצלחת
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: נתוני גובה

  קטגוריה ‫Pro
  מזהה מק"ט

‫B43B-2A59-C153 (כל העולם)

‫2C90-4807-194C (הודו)
  APIs ‫Maps JavaScript API,‏
‫Elevation API
  אירוע לחיוב בקשה מוצלחת ל-Elevation API
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Immersive Maps

  קטגוריה ‫Pro
  מזהה מק"ט

‫4816-83A2-9059 (כל העולם)

‫B383-D5A8-F843 (הודו)
  APIs מפות תלת-ממדיות ב-Maps JavaScript API
  אירוע לחיוב הצגה של מפה
  טריגרים

בקשה להצגה של מפה בוצעה בהצלחה אל מפות תלת-ממדיות ב-Maps JavaScript API.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

Map Tiles - 2D and Street Tiles

‫[ Essentials: Map Tiles ]

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫0164-F76D-680A (כל העולם)

‫DA70-1FF2-6B9D (הודו)
  APIs ‫Map Tiles API
  אירוע לחיוב בקשה שמחזירה משבצת של מפה דו-ממדית
  טריגרים
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫2A39-565F-B3B0 (כל העולם)

‫5B1B-D58C-99E2 (הודו)
  APIs ‫Map Tiles API
  אירוע לחיוב בקשה מוצלחת למשבצות ב-Street View
  טריגרים
  • משבצות ב-Street View
  • תמונות ממוזערות של Street View
  • מזהי פנורמה ב-Street View
  הערות
  תמחור מחירון (גלובלי)
מחירון (הודו)

Map Tiles - 3D Tiles

‫[ Enterprise: Map Tiles ]

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

C6E1-98B2-DBD0 (Global)

‫592E-920B-C911 (הודו)
  APIs ‫Map Tiles API
  אירוע לחיוב בקשה שמחזירה משבצת תלת-ממדית
  טריגרים 3D Tiles
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"טים של מוצרים של Routes

‫[ Essentials: Routes ]

מק"ט: Routes: Compute Routes Essentials

  קטגוריה ‫Essentials
  מזהה מק"ט

‫9EFF-679A-9B16 (כל העולם)

‫890F-D2B6-C2EA (הודו)
  APIs Compute Routes
  אירוע לחיוב בקשה מוצלחת ללא תכונות של Pro או Enterprise
  טריגרים בקשות לחישוב מסלולים שלא נעשה בהן שימוש בתכונות של Pro או Enterprise.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Routes: Compute Route Matrix Essentials

  קטגוריה ‫Essentials
  מזהה מק"ט

‫9392-1087-2045 (כל העולם)

‫AE55-A4D2-4177 (הודו)
  APIs ‫Compute Route Matrix
  אירוע לחיוב כל רכיב שמוחזר ללא תכונות של Pro או Enterprise
  טריגרים בקשות אל Compute Route Matrix שלא נעשה בהן שימוש בתכונות של Pro או Enterprise.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫6108-C697-9EA5 (כל העולם)

‫BFA2-4E15-25C5 (הודו)
  APIs הכבישים הקרובים ביותר
  אירוע לחיוב בקשה מוצלחת לשירות Nearest Roads
  טריגרים בקשה ל-Roads API שירות Nearest Roads
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Roads – Route Traveled

  קטגוריה ‫Pro
  מזהה מק"ט

‫9806-C277-BCCA (כל העולם)

‫C090-EC88-30C5 (הודו)
  APIs Roads API
  אירוע לחיוב בקשה מוצלחת לשירות Snap to Roads
  טריגרים בקשה לשירות Snap to Roads של Roads API
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Roads – Speed Limits

  קטגוריה ‫Pro
  מזהה מק"ט

‫BC44-A4CC-322A (כל העולם)

‫242A-7AE7-0C94 (הודו)
  APIs Roads API
  אירוע לחיוב

כל רכיב של הגבלת מהירות במערך speedLimits של גוף התגובה של ה-API.

הערה: בקשה אחת לקבלת הגבלות מהירות לאורך נתיב עשויה להחזיר כמה רכיבים של הגבלות מהירות בגוף התגובה.
  טריגרים בקשה לשירות Speed Limits של Roads API (גישה מוגבלת)
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Route Optimization: Single Vehicle Routing

  קטגוריה ‫Pro
  מזהה מק"ט

‫2020-AA6E-7D49 (גלובלי)

‫93D3-73B7-A3FC (הודו)
  APIs ‫Route Optimization API
  אירוע לחיוב בקשה מוצלחת למשלוח שמציינת בדיוק רכב אחד
  טריגרים בקשה לאופטימיזציה של מסלול משלוח שמציינת בדיוק כלי רכב אחד
  דוגמאות

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

  • רכב אחד
  • ‫10 משלוחים ייחודיים (עם 10 מיקומי משלוח או טעינות ייחודיים)

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

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

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

מק"ט: Routes: Compute Routes Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫02F7-1B55-DC90 (גלובלי)

‫3CC6-0DC6-1C5F (הודו)
  APIs Compute Routes
  אירוע לחיוב בקשה מוצלחת עם תכונות Pro
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Routes: Compute Route Matrix Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫2E25-887A-DAD4 (גלובלי)

‫CA04-7918-ACFC (הודו)
  APIs ‫Compute Route Matrix
  אירוע לחיוב כל רכיב שמוחזר עם תכונות Pro
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Enterprise: Route Optimization, Routes ]

מק"ט: Route Optimization: Fleet Routing

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫08E0-0D24-6C8E (ברחבי העולם)

‫783E-5817-1DA7 (הודו)
  APIs ‫Route Optimization API
  אירוע לחיוב כל בקשת משלוח מוצלחת של יותר מרכב אחד.
  טריגרים בקשת משלוח של יותר מרכב אחד התקבלה בהצלחה.

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

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

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

  • ‫5 כלי רכב
  • ‫10 משלוחים ייחודיים (עם 10 מיקומי משלוח או טעינות ייחודיים)

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

  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Routes: Compute Routes Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫6EBD-08E5-319A (כל העולם)

‫BFBE-DDB5-317C (הודו)
  APIs Compute Routes
  אירוע לחיוב בקשה מוצלחת עם תכונות Enterprise
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Routes: Compute Route Matrix Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫CEB3-E352-A99B (כל העולם)

‫046F-7FE8-E2EF (הודו)
  APIs ‫Compute Route Matrix
  אירוע לחיוב כל רכיב שמוחזר עם תכונות של Enterprise
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Enterprise: Navigation ]

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫AF6D-A7B0-31CF (כל העולם)

‫9C23-024B-56A1 (הודו)
  SDK ‫Navigation SDK ל-Android
‫Navigation SDK ל-iOS
  אירוע לחיוב כל יעד שנכלל בבקשה
  טריגרים

Android SDK

iOS SDK
  דוגמאות

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

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

‫[ Essentials: Places, Geocoding, Geolocation ]

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫4EF4-B17C-B31A (כל העולם)

‫F155-0371-DCAE (הודו)
  APIs ‫השלמה אוטומטית למקומות ב-Android,‏
השלמה אוטומטית למקומות ב-iOS,‏
ווידג'ט השלמה אוטומטית למקומות של Maps JavaScript API, ‏
השלמה אוטומטית למקומות באינטרנט
  אירוע לחיוב בקשה ללא טוקן סשן, או עם טוקן לא חוקי או שתוקפו פג
  טריגרים

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

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

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫EEA3-417B-DBA1 (כל העולם)

‫4764-9FA0-0FC0 (הודו)
  APIs ‫השלמה אוטומטית למקומות ב-Android,‏
השלמה אוטומטית למקומות ב-iOS,‏
ווידג'ט השלמה אוטומטית למקומות של Maps JavaScript API, ‏
השלמה אוטומטית למקומות באינטרנט
  אירוע לחיוב בקשה עם אסימון סשן
  טריגרים

מידע נוסף זמין במאמר בנושא השלמה אוטומטית (חדש) ותמחור לפי סשן.

  דוגמאות

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

  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫BAC8-4E68-E261 (גלובלי)

‫AB12-DA89-B523 (הודו)
  APIs שירות המרת כתובות לקואורדינטות (geocoding) של Maps JavaScript API,
Geocoding API
  אירוע לחיוב הבקשה הושלמה בהצלחה
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫51AF-D64F-9ABD (כל העולם)

‫8D4A-1891-61DA (הודו)
  APIs Geolocation API
  אירוע לחיוב הבקשה הושלמה בהצלחה
  טריגרים בקשה ל-Geolocation API
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Maps Grounding Lite

  קטגוריה ‫Essentials
  מזהה מק"ט

‫8CD0-1602-5324 (כל העולם)

‫E1E0-C208-1C60 (הודו)
  APIs ‫Maps Grounding Lite
  אירוע לחיוב בקשה ל-Maps Grounding Lite API
  טריגרים בקשה ל-Maps Grounding Lite API
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫5C36-E272-E88F (כל העולם)

‫FAA1-1118-93BE (הודו)
  APIs ‫Places API Place Details
  אירוע לחיוב בקשה מוצלחת רק לשדות של תעודת זהות
  טריגרים

שדות ל-Android SDK

Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME

שדות ל-iOS

GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

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

id
photos

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

attributions
id
moved_place
moved_place_id
name*
photos

‫* השדה name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. כדי לקבל את שם המקום בטקסט, צריך לבקש את השדה displayName במק"ט Pro.

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

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

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

SKU: Places API Place Details Essentials

  קטגוריה ‫Essentials
  מזהה מק"ט

‫6E05-E1C3-8D85 (גלובלי)

‫8036-9499-4AF9 (הודו)
  APIs Place Details (חדש)
  אירוע לחיוב בקשה מוצלחת רק לשדות של Place Details Essentials
  טריגרים

שדות ל-Android SDK

Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS*
    * Use instead of Place.Field.ADDRESS (deprecated).
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

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

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

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

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫635D-A9DD-C520 (כל העולם)

‫9C44-5A2D-4E06 (הודו)
  APIs חיפוש טקסט (חדש)
  אירוע לחיוב בקשה מוצלחת לקבלת מזהים בלבד
  טריגרים

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.name*
nextPageToken
places.movedPlace
places.movedPlaceId

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

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

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

מק"ט: Places UI Kit Query


  קטגוריה ‫Essentials
  מזהה מק"ט

‫0678-4F72-DA7C (כל העולם)

‫B10D-0B66-6EAD (הודו)
  APIs ‫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 (הודו)
  APIs ‫Places UI Kit Android,‏
Places UI Kit iOS,‏
Places UI Kit JavaScript
  אירוע לחיוב סשן
  טריגרים המק"ט הזה מופעל על ידי בקשות של Places UI Kit Basic Autocomplete:

Android

Basic Autocomplete Component

iOS

Basic Autocomplete Component

JavaScript

רכיב בסיסי של השלמה אוטומטית
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫91DF-9B59-4BBD (גלובלי)

‫0301-2887-FE47 (הודו)
  APIs Time Zone API
  אירוע לחיוב בקשה מוצלחת ל-Time Zone API
  טריגרים בקשה אל Time Zone API.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Pro: Address Validation, Places ]

מק"ט: Address Validation Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫A2E0-53FF-0BE3 (גלובלי)

‫4EB5-381D-BD8E (הודו)
  APIs ‫Address Validation API
  אירוע לחיוב בקשה מוצלחת ל-Address Validation API
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Places API חיפוש בקרבת מקום Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫99F9-A108-83A6 (כל העולם)

‫33DE-5C83-8354 (הודו)
  APIs חיפוש בקרבת מקום (חדש)
  אירוע לחיוב בקשה מוצלחת לשדות 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.containingPlaces
places.displayName
places.formattedAddress
places.googleMapsLinks
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 כדי לגשת לשם הטקסט של המקום.

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

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

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

מק"ט: Places API Place Details Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫4ED6-464A-2AFC (כל העולם)

‫1F70-206B-61DF (הודו)
  APIs ‫Places API Place Details
  אירוע לחיוב בקשה מוצלחת לשדות 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
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
  חיוב על מסכות שדות

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

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

SKU: Places API Text Search Pro

  קטגוריה ‫Pro
  מזהה מק"ט

‫4FDA-34B1-A910 (גלובלי)

‫2DB9-E41E-AC2A (הודו)
  APIs חיפוש טקסט (חדש)
  אירוע לחיוב בקשה מוצלחת לשדות 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.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

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

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

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

מק"ט: Places Aggregate API

  קטגוריה ‫Pro
  מזהה מק"ט

‫546C-66B2-E5A6 (כל העולם)

‫CA83-2F48-1131 (הודו)
  APIs ‫Places Aggregate API
  אירוע לחיוב הבקשה לתכונות Pro בוצעה בהצלחה
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Enterprise: Address Validation, Places ]

מק"ט: Address Validation Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫10F3-119A-C6EC (כל העולם)

‫D73D-9896-24CF (הודו)
  APIs ‫Address Validation API
  אירוע לחיוב סשן שמסתיים בבקשה לאימות כתובת
  טריגרים
  • סשן של השלמה אוטומטית (חדש) שמסתיים בשיטה ValidateAddress (REST).
  • סשן של השלמה אוטומטית (חדש) שמסתיים בשיטה ValidateAddress (gRPC).
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

מק"ט: Places API חיפוש בקרבת מקום Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫772E-9975-BE34 (כל העולם)

‫B049-A814-B2A8 (הודו)
  APIs חיפוש בקרבת מקום (חדש)
  אירוע לחיוב בקשה מוצלחת לשדות 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.transitStation
places.userRatingCount
places.websiteUri

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

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

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

מק"ט: Places API חיפוש בקרבת מקום Enterprise + Atmosphere

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫F20E-7034-0EF7 (כל העולם)

‫1DC0-87A6-65E7 (הודו)
  APIs חיפוש בקרבת מקום (חדש)
  אירוע לחיוב הבקשה לשדות של אווירה בוצעה בהצלחה
  טריגרים

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
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

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

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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.
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"ט: Places API Place Details Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫2D9A-3DE0-3766 (כל העולם)

‫448A-2967-E6BF (הודו)
  APIs ‫Places API Place Details
  אירוע לחיוב בקשה מוצלחת לשדות 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
transitStation
userRatingCount
websiteUri

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

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

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

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫EB23-5ECC-F753 (כל העולם)

‫586E-FEBE-4FD2 (הודו)
  APIs ‫Places API Place Details
  אירוע לחיוב בקשה מוצלחת לשדות Enterprise + Atmosphere
  טריגרים

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

* חיפוש טקסט וחיפוש בקרבת מקום בלבד

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

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

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

מק"ט: Place Details Photos

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫DCD1-FE97-8C71 (כל העולם)

‫0AF7-8463-1BC9 (הודו)
  APIs Place Photos (חדש)
  אירוע לחיוב בקשה מוצלחת לתמונה
  טריגרים בקשה לPlace Photos (חדש)
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

SKU: Places API Text Search Enterprise

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫E967-44BC-B44D (כל העולם)

‫D112-1B19-2E0B (הודו)
  APIs חיפוש טקסט (חדש)
  אירוע לחיוב בקשה מוצלחת לשדות 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.transitStation
places.userRatingCount
places.websiteUri

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

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

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

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫120C-BEC3-B48F (גלובלי)

‫0FD0-B42B-DFDA (הודו)
  APIs חיפוש טקסט (חדש)
  אירוע לחיוב בקשה מוצלחת לשדות Enterprise + Atmosphere
  טריגרים

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
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine

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

places.allowsDogs
places.curbsidePickup
places.delivery
places.dineIn
places.editorialSummary
places.evChargeAmenitySummary
places.evChargeOptions
places.fuelOptions
places.generativeSummary
places.goodForChildren
places.goodForGroups
places.goodForWatchingSports
places.liveMusic
places.menuForChildren
places.neighborhoodSummary
places.parkingOptions
places.paymentOptions
places.outdoorSeating
places.reservable
places.restroom
places.reviews
places.reviewSummary
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.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

‫[ Essentials: סביבה ]

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫90A9-B3FA-4A12 (גלובלי)

‫03A0-8EE9-1B37 (הודו)
  APIs Air Quality API
  אירוע לחיוב בקשה מוצלחת לנתוני איכות האוויר
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

מק"ט: Solar API Building Insights

  קטגוריה ‫Essentials
  מזהה מק"ט

‫1856-4940-856A (כל העולם)

‫FB57-6661-D18C (הודו)
  APIs ‫Solar API
  אירוע לחיוב הבקשה הושלמה בהצלחה
  טריגרים בקשות לנקודת הקצה (endpoint) של Building Insights ב-Solar API.
  דוגמאות
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫9DB8-727A-ACFE (כל העולם)

‫0E82-7FAF-9FD2 (הודו)
  APIs Weather API
  אירוע לחיוב בקשה מוצלחת ל-Weather API
  טריגרים

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

‫[ Pro: Environment ]

מק"ט: Pollen Usage

  קטגוריה ‫Pro
  מזהה מק"ט

‫6CDF-1930-8F86 (גלובלי)

‫71B3-45C0-4D9A (הודו)
  APIs Pollen API
  אירוע לחיוב בקשה מוצלחת ל-Pollen API
  טריגרים
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

‫[ Enterprise: Environment ]

מק"ט: Solar API Data Layers

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫54EE-B608-7DDE (כל העולם)

‫259F-15E4-980A (הודו)
  APIs ‫Solar API
  אירוע לחיוב בקשה שבוצעה בהצלחה לנקודת הקצה (endpoint) של שכבות הנתונים ב-Solar API
  טריגרים בקשות למקור המידע dataLayers ב-Solar API
  הערות

גישה לכמה כתובות URL של תמונות מאותה בקשה לא מפעילה חיובים נוספים.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

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

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

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

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

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

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

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

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

‫[ Essentials: Places Legacy ]

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫7384-2DE4-D388 (גלובלי)

‫2164-BC00-53DC (הודו)
  APIs ‫השלמה אוטומטית למקומות (מדור ישן) Android,‏
השלמה אוטומטית למקומות (מדור ישן) iOS,‏
השלמה אוטומטית למקומות (מדור ישן) Web
  אירוע לחיוב בקשה שלא כוללת טוקן סשן
  טריגרים
  דוגמאות

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

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

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫E9C9-934B-DDB1 (כל העולם)
  APIs ‫השלמה אוטומטית למקומות (מדור ישן) Android,‏
השלמה אוטומטית למקומות (מדור ישן) iOS,‏
השלמה אוטומטית למקומות (מדור ישן) Web
  אירוע לחיוב סשן
  טריגרים
  • ‫Android: שיחה אל fetchPlace()
  • ‫iOS: קריאה אל fetchPlaceFromPlaceID:
  • שירות אינטרנט: בקשה לקבלת פרטים על מקום

השדות בבקשה:

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

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

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

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

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

  • השלמה אוטומטית (כלולה ב-Place Details) – לכל סשן
  • פרטי מקומות
  • נתונים בסיסיים

דוגמה לבקשה לפי פלטפורמה:

בקשות Android

findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ))
findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ))
fetchPlace() (with a FetchPlaceRequest including the Place ID, and the ADDRESS field)

בקשות ב-iOS

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: (כולל מזהה המקום והשדה GMSPlaceFieldFormattedAddress)

בקשות לשירותי אינטרנט

Places Autocomplete Request (input="par", session_token: XYZ)
Places Autocomplete Request (input="paris", session_token: XYZ)
Places Details (place_id, session_token: XYZ, fields:formatted_address)

  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

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

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

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

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

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

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

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫75D4-C522-326B (כל העולם)

‫5D7B-1F7B-395E (הודו)
  APIs Place Details (מדור קודם) עם שדות בסיסיים
חיפוש מקום (מדור קודם) עם שדות בסיסיים
  אירוע לחיוב הבקשה לשדות של נתונים בסיסיים התקבלה בהצלחה
  טריגרים

שדות ל-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.
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫44A2-D839-A3AC (גלובלי)

‫FE05-60A4-CDDF (הודו)
  APIs Places Web Service Find Place
  אירוע לחיוב בקשה מוצלחת רק לגבי place_id
  טריגרים בקשת חיפוש מקום ללא שדות שצוינו, או רק עם השדה place_id: FindPlace(fields: place_id).
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"ט: Place Details – ID Refresh (פרטי מקום – רענון מזהה)

  קטגוריה ‫Essentials
  מזהה מק"ט

‫2D88-4302-6299 (כל העולם)

‫4604-F56B-7086 (הודו)
  APIs Place Details (מאמר בנושא גרסה קודמת)
  אירוע לחיוב בקשה מוצלחת רק לשדות של תעודת זהות
  טריגרים בקשה שכוללת רק את השדה מזהה מקום: getPlaceDetails(fields: place_id).
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Essentials
  מזהה מק"ט

‫C4B1-8805-63EF (כל העולם)

‫59E9-EB83-5CA3 (הודו)
  APIs שירות השלמה אוטומטית של שאילתות
  אירוע לחיוב הבקשה הושלמה בהצלחה
  טריגרים

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

  תמחור מחירון (גלובלי)
מחירון (הודו)

‫[ Pro: Places Legacy ]

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫B52C-8320-6DC5 (גלובלי)

‫C625-D3CE-DF37 (הודו)
  APIs ‫השלמה אוטומטית למקומות (מדור ישן) Android,‏
השלמה אוטומטית למקומות (מדור ישן) iOS,‏
השלמה אוטומטית למקומות (מדור ישן) Web
  אירוע לחיוב סשן
  טריגרים
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫7218-264C-D1D7 (כל העולם)

‫0862-F46E-1A1A (הודו)
  APIs ‫Places SDK ל-Android,
‫Places SDK ל-iOS
  אירוע לחיוב הבקשה הושלמה בהצלחה
  טריגרים
  דוגמאות

בדוגמאות הבאות מוצגים המק"טים שחויבתם עליהם כששלחתם בקשה ל-Find Current Place וציינתם שדות מהמק"טים Basic,‏ Contact ו-Atmosphere data. כדי לראות את המק"טים בחשבון, אפשר לעיין בחשבון לפי מק"ט כמו שמתואר במאמר ניתוח השימוש והעלות לפי מק"ט.

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

בחשבון שלכם יופיעו מספרי המלאי הבאים:

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

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

בחשבון שלכם יופיעו מספרי המלאי הבאים:

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

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

בחשבון שלכם יופיעו מספרי המלאי הבאים:

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

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫DC67-3188-2294 (כל העולם)

ECB4-087C-9A27 (India)
  APIs Places Web Service Find Place
  אירוע לחיוב בקשה מוצלחת ליותר משדה המזהה
  טריגרים בקשת חיפוש מקום עם יותר ממה שצוין בשדה המזהה.
  דוגמאות

בדוגמאות הבאות מוצגים המק"טים שחויבתם עליהם כששלחתם בקשה ל-Find Current Place וציינתם שדות מהמק"טים Basic,‏ Contact ו-Atmosphere data. כדי לראות את המק"טים בחשבון, אפשר לעיין בחשבון לפי מק"ט כמו שמתואר במאמר ניתוח השימוש והעלות לפי מק"ט.

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

בחיוב יופיעו המק"טים האלה:

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

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

בחשבון שלכם יופיעו מספרי המלאי הבאים:

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

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

בחשבון שלכם יופיעו מספרי המלאי הבאים:

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

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫6B23-8A17-D29D (כל העולם)

‫CC66-BE0E-2477 (הודו)
  APIs חיפוש בקרבת מקום
  אירוע לחיוב הבקשה לתכונות Pro בוצעה בהצלחה
  טריגרים

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

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

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

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫E95A-86C7-7F47 (כל העולם)

‫102E-888D-5596 (הודו)
  APIs חיפוש טקסט (מאמר שמתייחס לגרסה קודמת)
  אירוע לחיוב בקשה מוצלחת ל-חיפוש טקסט (מדור קודם)
  טריגרים

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

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

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

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

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

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

  קטגוריה ‫Pro
  מזהה מק"ט

‫FC5C-DF28-543F (כל העולם)

‫F7AA-FEF9-C90E (הודו)
  APIs Place Details (מאמר בנושא גרסה קודמת)
  אירוע לחיוב הבקשה לתכונות Pro בוצעה בהצלחה
  טריגרים

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

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

‫[ Enterprise: Places Legacy ]

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

מק"ט נתונים שמשמש לחיוב על השדות Atmosphere Data בבקשה מסוג Places Details או חיפוש מקום.

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫D63D-5CC5-302A (כל העולם)

‫0CE0-1963-137E (הודו)
  APIs Place Details (Legacy) עם שדות אווירה
חיפוש מקום (Legacy) עם שדות אווירה
  אירוע לחיוב בקשה מוצלחת לשדות נתונים של Atmosphere
  טריגרים

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

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

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.
  תמחור רשימת מחירים (גלובלית)
רשימת מחירים (הודו)

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

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫F095-CD01-81B2 (גלובלי)

‫A03F-5079-C66C (הודו)
  APIs Place Details (Legacy) עם Contact fields
חיפוש מקום (Legacy) עם Contact fields
  אירוע לחיוב בקשה מוצלחת לשדות של פרטים ליצירת קשר
  טריגרים

שדות ל-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.
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

  קטגוריה ‫Enterprise
  מזהה מק"ט

‫81E7-85D0-58A7 (גלובלי)

‫9F4B-2E19-1B63 (הודו)
  APIs תמונה של מקום (מאמר שמתייחס לגרסה קודמת)
  אירוע לחיוב בקשה מוצלחת לתמונה
  טריגרים
  • ‫Android: בקשות אל fetchPhoto()
  • ‫iOS: בקשות אל loadPlacePhoto:
  • ‫JavaScript: בקשות אל PlacePhoto.getUrl() לטעינת נתוני פיקסל תמונה.
  • שירות אינטרנט: בקשות לשירות Place Photos של Places API.
  תמחור מחירון (גלובלי)
מחירון (הודו)

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

‫[ Essentials: Routes Legacy ]

מק"ט: הוראות

  קטגוריה ‫Essentials
  מזהה מק"ט

‫28A8-3EB4-4595 (כל העולם)

‫4714-291C-3199 (הודו)
  APIs ‫Directions Service של Maps JavaScript API,‏
‫Directions API (גרסה קודמת)
  אירוע לחיוב בקשה מוצלחת ללא תכונות של Pro או Enterprise
  טריגרים שאילתות שלא מפעילות מק"ט עם דירוג גבוה יותר
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"ט: Distance Matrix

  קטגוריה ‫Essentials
  מזהה מק"ט

‫C1B6-FF9D-7700 (גלובלי)

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

‫[ Pro: Routes Legacy ]

מק"ט: Directions Advanced

  קטגוריה ‫Pro
  מזהה מק"ט

‫9407-00C2-CF85 (כל העולם)

‫E27B-BD57-FD7D (הודו)
  APIs ‫Directions Service של Maps JavaScript API,‏
‫Directions API (גרסה קודמת)
  אירוע לחיוב בקשה מוצלחת עם תכונות Pro
  טריגרים
  תמחור מחירון (גלובלי)
מחירון (הודו)

מק"ט: Distance Matrix Advanced

  קטגוריה ‫Pro
  מזהה מק"ט

‫DFAE-763F-CF6E (כל העולם)

‫C0F4-32AE-F6D1 (הודו)
  APIs ‫ Distance Matrix API (Legacy),
Maps JavaScript API Distance Matrix Service
  אירוע לחיוב כל רכיב שמוחזר עם תכונות Pro. כל בקשה שנשלחת אל Distance Matrix API יוצרת רכיבים, כאשר מספר הרכיבים שווה למספר origins כפול מספר destinations.
  טריגרים
  תמחור מחירון (גלובלי)
מחירון (הודו)