בקטע הזה מפורטים המק"טים שמוגדרים למוצרים המרכזיים של פלטפורמת מפות Google. המוצרים העיקריים הם בתשלום לפי שימוש, ומשלמים רק על המק"טים שבהם אתם משתמשים.
לגבי כל מק"ט שמופיע ברשימה יופיעו הפרטים הבאים:
- שם המק"ט כפי שהוא מופיע בדוח החיוב.
- פרטים שמתארים את סוג השימוש שמפעיל את המק"ט (אירועים לחיוב).
- המחיר לכל שימוש ברמות התמחור שמבוססות על נפח.
- הערות נוספות לגבי תמחור ספציפי למק"ט.
כאן אפשר לחפש מק"טים של מוצרים ספציפיים, או להשתמש במחשבון התמחור והשימוש כדי להעריך את השימוש לעומת העלות הכוללת לכל API.
טבלת המוצרים או המק"טים של GMP
מק"טים של מוצרי מפות Google
ממשקי ה-API במפות כוללים את: Maps SDK ל-Android, Maps SDK ל-iOS, Maps JavaScript API, Maps Static API, Street View Static API ו-Maps Embed API.
מק"ט: מפות סטטיות שמותאמות לניידים
כולל אובייקט של מפת Google במצב טעינה מהירה, שלא נטען עם מזהה מפה, באפליקציה לנייד עם SDK של מפות ל-Android.
טווח נפח חודשי (מחיר לכל טעינת מפה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
לכל מופע של אובייקט מפה של Google במצב טעינה מהירה באפליקציה לנייד של Maps SDK ל-Android, נצברת טעינה אחת של מפה. המפות נוצרות באמצעות מכונות של הכיתות MapFragment
, SupportMapFragment
או MapView
. אירוע של טעינת מפה נספר בכל פעם שמתבצעת קריאה ל-method onCreate()
הרלוונטי.
מק"ט: מפות דינמיות לנייד
אובייקט של מפת Google, שלא נטען עם מזהה מפה, באפליקציה לנייד של Maps SDK for Android או של Maps SDK for iOS.
טווח נפח חודשי (מחיר לכל טעינת מפה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
נצברת עומסה אחת של מפה לכל מופע של אובייקט מפה של Google באפליקציה לנייד של Maps SDK for Android או של Maps SDK for iOS:
- אחת מהקלאסות
MapFragment
,SupportMapFragment
אוMapView
ב-Android. טעינה של מפה נספרת בכל פעם שמתבצעת קריאה ל-methodonCreate()
הרלוונטי. - אובייקט
GMSMapView
ב-iOS.
אינטראקציות של משתמשים עם המפה, כמו החלפת שכבות במפה, שינוי מרחק התצוגה או החלפת מיקום המפה, לא יוצרות עומסי טעינה נוספים של המפה. לפי מודל התמחור 'תשלום לפי שימוש', היצירה של תמונה פנורמית של Street View כבר לא מחויבת כטעינה של מפה מקורית לנייד. החיוב מתבצע כStreet View דינמי.
מק"ט: הטמעה ומק"ט: הטמעה מתקדמת
כל הבקשות ל-Maps Embed API זמינות ללא תשלום, ללא הגבלת שימוש.
מק"ט: Static Maps
בקשה ל-Maps Static API.
טווח נפח חודשי (מחיר לכל טעינת מפה) |
||
---|---|---|
0.002 USD לכל (2.00 USD ל-1,000) |
0.0016 USD לכל (1.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: מפות דינמיות
אפליקציה שמציגה מפה טעונה עם או בלי מזהה מפה באמצעות ממשק ה-API של מפות Google ל-JavaScript, או מפה טעונה עם מזהה מפה באמצעות SDK של מפות ל-Android או SDK של מפות ל-iOS.
טווח נפח חודשי (מחיר לכל טעינת מפה) |
||
---|---|---|
0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
אינטראקציות של משתמשים עם המפה, כמו החלפת שכבות מפה, שינוי מרחק התצוגה או החלקה, לא יוצרות עומסי טעינה נוספים של המפה.
מק"ט: Street View סטטי
מעכשיו, תמונות פנורמיות של Street View והעלאות של מפות מחויבות בנפרד. על כל בקשה להטמעת פנורמה סטטית (לא אינטראקטיבית) של Street View ב-Street View Static API, תחויבו על פנורמה סטטית של Street View. אין חיוב על שימוש בנקודת הקצה מטא-נתונים של תמונות Street View.
טווח נפח חודשי (מחיר לכל PANORAMA) |
||
---|---|---|
0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Dynamic Street View
מעכשיו, תמונות פנורמיות של Street View והעלאות של מפות מחויבות בנפרד. החיוב על פנורמה דינמית של Street View מתבצע על כל יצירה של אובייקט פנורמה באפליקציה עם Maps JavaScript API, SDK של מפות ל-Android או SDK של מפות ל-iOS.
טווח נפח חודשי (מחיר לכל PANORAMA) |
||
---|---|---|
0.014 USD לכל (14.00 USD ל-1,000) |
0.0112 דולר ארה"ב לכל (11.20 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
יצירת מופע של אובייקט פנורמה מתרחשת:
- ב-JavaScript, באמצעות השיטה
Map.getStreetView()
או הכיתהgoogle.maps.StreetViewPanorama()
. לא תחויבו על חוויית Street View המובנית שמבוססת על אטב-האיש של Street View, ולא על השימוש בכיתהStreetViewService()
. - ב-Android, באמצעות אחת מהמערכות
StreetViewPanoramaFragment
,SupportStreetViewPanoramaFragment
אוStreetViewPanoramaView
. תמונה פנורמית נספרת בכל פעם שמפעילים את השיטה הרלוונטיתonCreate()
. - ב-iOS, באמצעות האובייקט
GMSPanoramaView
.
מק"ט: Aerial View
בקשה ל-Aerial View API שמחזירה כתובת URL של סרטון ממעוף גבוה.
טווח נפח חודשי (מחיר לכל בקשה lookupVideo מוצלחת) |
||
---|---|---|
0.016 USD לכל (16.00 USD ל-1,000) |
0.0128 USD לכל (12.80 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
החיוב מתבצע רק על קריאות אל
lookupVideo
שמחזירות כתובות URL. תשובה אחת מוצלחת של lookupVideo
עשויה להחזיר כמה כתובות URL, כל אחת ברזולוציה או בכיוון שונים, אבל היא נחשבת לאירוע אחד לחיוב בלבד. חשוב לזכור שהתמחור לא תלוי בכך שמשתמשי הקצה צפו בפועל בכתובות ה-URL האלה.
ניתוב מק"טים של מוצרים
ממשקי ה-API ב-Routes כוללים את: Directions API, Distance Matrix API ו-Roads API.
מק"ט: מסלול
בקשה ל שירות המסלולים של Maps JavaScript API (לא כולל בקשות שמפעילות את המק"ט לחיוב Directions Advanced) או ל-Directions API.
טווח נפח חודשי (מחיר לכל שאילתה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Directions Advanced
בקשה לשירות המסלולים של Maps JavaScript API או ל-Directions API שמשתמשת במידע על מצב התנועה, ביותר מ-10 נקודות עצירה, באופטימיזציה של נקודות עצירה ו/או במודיפיקציות של מיקום.
טווח נפח חודשי (מחיר לכל שאילתה) |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט מתקדם של שירות מסלולים מחויב על שירות המסלולים של Maps JavaScript API או על בקשה ל-Directions API שמשתמשת באחת או יותר מהאפשרויות הבאות:
- מידע על מצב התנועה נעשה שימוש בנתוני התנועה כשכל התנאים הבאים מתקיימים (אלה התנאים הנדרשים כדי לקבל את השדה
duration_in_traffic
בתשובה ל'הוראות הגעה'):- הפרמטר
travel
mode
הואdriving
, או שהוא לא צוין (driving
הוא ברירת המחדל של אופן הנסיעה). - הבקשה כוללת
פרמטר
departure_time
תקין. אפשר להגדיר אתdeparture_time
לשעה הנוכחית או למועד כלשהו בעתיד. הוא לא יכול להיות בעבר. - הבקשה לא כוללת נקודות עצירה. אם הבקשה כוללת נקודות ציון, צריך להוסיף את התחילית
via:
לכל נקודת ציון כדי להשפיע על המסלול, אבל להימנע מעצירות ביניים. לדוגמה,&waypoints=via:San Francisco|via:Mountain View|...
- הפרמטר
travel
- יותר מ-10 נקודות דרך (בין 11 ל-25).
- אופטימיזציה של נקודות דרך
הפרמטר
optimize
מוגדר לערךtrue
עבור נקודות דרך. לדוגמה,&waypoints=optimize:true|San Francisco|Mountain View|...
- גורמים מתאימים למיקום כשמשתמשים במשתני המיקום הבאים כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
side_of_road
heading
מק"ט: Distance Matrix
בקשה ל- Distance Matrix API או ל שירות מטריצת המרחקים של Maps JavaScript API (לא כולל בקשות שמפעילות את המק"ט לחיוב של Distance Matrix Advanced).
טווח נפח חודשי (מחיר לאלמנט) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
כל שאילתה שנשלחת ל-Distance Matrix API יוצרת רכיבים, כאשר המספר של origins
כפול המספר של destinations
שווה למספר הרכיבים.
מק"ט: Distance Matrix Advanced
בקשה ל- Distance Matrix API או ל שירות מטריצת המרחקים של Maps JavaScript API שמשתמשת במידע על תנועה ו/או במודיפיקציות של מיקום.
טווח נפח חודשי (מחיר לאלמנט) |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
כל שאילתה שנשלחת ל-Distance Matrix API יוצרת רכיבים, כאשר המספר של origins
כפול המספר של destinations
שווה למספר הרכיבים.
מק"ט מתקדם של מטריצת מרחקים מחויב על שימוש ב- Distance Matrix API או ב שירות מטריצת המרחקים של Maps JavaScript API, שמשתמש באחד או יותר מהרכיבים הבאים:
- מידע על מצב התנועה המערכת משתמשת בנתוני התנועה כשכל התנאים הבאים מתקיימים (אלה התנאים הנדרשים כדי לקבל את השדה
duration_in_traffic
בתשובה של מטריצת המרחק):- הפרמטר
travel
mode
הואdriving
, או שהוא לא צוין (driving
הוא ברירת המחדל של אופן הנסיעה). - הבקשה כוללת
פרמטר
departure_time
תקין. אפשר להגדיר אתdeparture_time
לשעה הנוכחית או למועד כלשהו בעתיד. הוא לא יכול להיות בעבר.
- הפרמטר
travel
- גורמים מתאימים למיקום כשמשתמשים במשתני המיקום הבאים כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
side_of_road
heading
מק"ט: כבישים – המסלול שנסע
בקשה לשירות Snap to Roads של Roads API.
טווח נפח חודשי (מחיר לכל שאילתה) |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: כבישים – הכביש הקרוב ביותר
בקשה לשירות Nearest Roads של Roads API.
טווח נפח חודשי (מחיר לכל שאילתה) |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: כבישים – מגבלות מהירות
בקשה ל שירות המגבלות המהירות של Roads API.טווח נפח חודשי (מחיר לאלמנט) |
||
---|---|---|
0.02 USD לכל (20.00 USD ל-1,000) |
0.016 USD לכל (16.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
החיוב על בקשות של הגבלת מהירות מתבצע לפי רכיב של הגבלת מהירות שמוחזר בתשובה של ה-API. הסכום הזה תמיד יהיה שווה למספר הנקודות שהועברו בבקשה המקורית או קטן ממנו.
מק"ט: Routes: Compute Routes - Basic
בקשה ל-Compute Routes.
טווח נפח חודשי מחיר לכל שאילתה |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Routes: Compute Routes – Advanced
בקשה ל-Compute Routes שמשתמשת בתכונות מתקדמות.
טווח נפח חודשי מחיר לכל שאילתה |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
המק"ט המתקדם מחויב על בקשה של Compute Routes שמשתמשת באחת או יותר מהתכונות הבאות:
- בין 11 ל-25 נקודות ציון ביניים
- ניתוח מצב התנועה או ניתוח מצב התנועה לצורך בחירת מסלול אופטימלי. אפשרויות הניתוב האלה תואמות להגדרה של המאפיין
routingPreference
בבקשה לערךTRAFFIC_AWARE
או לערךTRAFFIC_AWARE_OPTIMAL
. - גורמים מתאימים למיקום כשמשתמשים באפשרויות הבאות כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
מק"ט: Routes: Compute Routes - Preferred
בקשה ל-Compute Routes שמשתמשת בתכונות מועדפות.
טווח נפח חודשי מחיר לכל שאילתה |
||
---|---|---|
0.015 USD לכל (15.00 USD ל-1,000) |
0.012 דולר ארה"ב לכל (12.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
המק"ט המועדף מחויב על בקשה של Compute Routes שמשתמשת באחת או יותר מהתכונות הבאות:
מק"ט: Routes: Compute Route Matrix – Basic
בקשה לחישוב מטריצת מסלולים.
טווח נפח חודשי מחיר לאלמנט |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Routes: Compute Route Matrix - Advanced
בקשה ל-Compute Route Matrix שמשתמשת בתכונות מתקדמות.
טווח נפח חודשי מחיר לאלמנט |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
החיוב על המק"ט המתקדם חל על בקשה של Compute Route Matrix שמשתמשת באחת או יותר מהתכונות הבאות:
- ניתוח מצב התנועה או ניתוח מצב התנועה לצורך בחירת מסלול אופטימלי. אפשרויות הניתוב האלה תואמות להגדרה של המאפיין
routingPreference
בבקשה לערךTRAFFIC_AWARE
או לערךTRAFFIC_AWARE_OPTIMAL
. - גורמים מתאימים למיקום כשמשתמשים באפשרויות הבאות כדי לציין איך הנהגים צריכים להגיע למיקום מסוים:
מק"ט: Routes: Compute Route Matrix - Preferred
בקשה ל-Compute Route Matrix שמשתמשת בתכונות מועדפות.
טווח נפח חודשי מחיר לאלמנט |
||
---|---|---|
0.015 USD לכל (15.00 USD ל-1,000) |
0.012 דולר ארה"ב לכל (12.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
החיוב על המק"ט המועדף חל על בקשה של Compute Route Matrix שמשתמשת באחת או יותר מהתכונות הבאות:
מק"ט: Route Optimization: Single Vehicle Routing
בקשה ל- Route Optimization API שמציינת רכב אחד בלבד.
טווח נפח חודשי (מחיר למשלוח) |
||
---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Route Optimization: Fleet Routing
בקשה ל- Route Optimization API שמציינת יותר מרכב אחד.
טווח נפח חודשי (מחיר למשלוח) |
||
---|---|---|
0.03 USD לכל (30.00 USD ל-1,000) |
0.014 USD לכל (14.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"טים של מוצרים ב-Places (חדש)
מידע על מסכות שדות
משתמשים במסכות שדות, שנקראות גם רשימות שדות, בבקשות כדי לציין את רשימת השדות שתוחזר בתגובה. לאחר מכן, תחויבו לפי המק"ט הגבוה ביותר שרלוונטי לבקשה שלכם. כלומר, אם בוחרים שדות גם במק"ט (בסיסי) וגם במק"ט (מתקדם), החיוב מתבצע על סמך המק"ט (מתקדם).
שימוש במסכת שדה הוא שיטה טובה לתכנון כדי להבטיח שלא מבקשים נתונים מיותרים, וכך להימנע מזמן עיבוד ומחיובים מיותרים.
מידע על סשנים של השלמה אוטומטית (חדשים)
סשן של השלמה אוטומטית (חדש) כולל בקשה אחת או יותר של השלמה אוטומטית (חדש) ובקשת פרטי מקום (חדש) או בקשת אימות כתובת. אותו אסימון סשן מועבר לבקשה 'השלמה אוטומטית (חדשה)' ולבקשה הבאה 'פרטי המקום (חדשה)' או 'אימות כתובת'.
סשן מתחיל בבקשה הראשונה להשלמה אוטומטית (חדשה). לאחר מכן, כשהמשתמש בוחר באחת מההצעות של המילוי האוטומטי (חדש), נשלחת בקשה לפרטים של מקום (חדש) או בקשה לאימות כתובת. אם סשן מסוים לא הושלם, כלומר לא נשלחה בקשה מסוג 'פרטי מקום (חדש)' או בקשה מסוג 'אימות כתובת', המערכת מחייבת על בקשות מסוג 'השלמה אוטומטית (חדש)' כאילו לא סופק אסימון סשן.
אחרי שמשתמש בוחר מקום (כלומר, נשלחת בקשה לפרטים של מקום (חדש) או בקשה לאימות כתובת), צריך להתחיל סשן חדש באמצעות אסימון סשן חדש.
אסימון סשן תקף לסשן אחד בלבד, ולא ניתן להשתמש בו ביותר מסשן אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב לא תקף והבקשות יחויבו כאילו לא סופק אסימון סשן.
מק"ט: בקשות להשלמה אוטומטית
Autocomplete Requests (בקשות להשלמה אוטומטית) – מק"ט לחיוב על כל בקשה ל-Autocomplete API (חדש) שלא כוללת אסימון סשן.
החיוב מתבצע גם אם אתם משתמשים באסימוני סשן, ובמקרים הבאים:
- כדי לסיים את הסשנים, שולחים בקשה אחת ל-Place Details (New) שבה מבקשים את כל השדות שמוגדרים על ידי SKU: Place Details (Location Only).
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
- כדי לסיים את הסשן או לבטל אותו, צריך לבצע קריאה ל-SKU: Place Details (IDs Only). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות SKU: Autocomplete Requests.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1,000) |
0.00227 USD לכל (2.27 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: שימוש בסשן של השלמה אוטומטית
מק"ט מסוג Autocomplete Session Usage מחויב על כל בקשה ל-Autocomplete API (חדש) שכוללת אסימון סשן.
המק"ט הזה מחויב בתרחישים הבאים:
סשן ההשלמה האוטומטית הסתיים על ידי קריאה ל-SKU: Place Details (Location Only):
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Place Details (Basic, Advanced, or Preferred).
קריאה לקבלת פרטי מקום שמבקשת כל שדה מ-מק"ט: פרטי מקום (בסיסי, מתקדם או מועדף) מחויבת לפי מק"ט: פרטי מקום (מועדף).
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Address Validation Preferred.
למידע נוסף, ראו השלמה אוטומטית (חדש) ותמחור סשנים.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD לכל (0.00 USD לכל 1,000) |
0.00 USD לכל (0.00 USD לכל 1,000) |
0.00 USD לכל (0.00 USD לכל 1,000) |
מק"ט: פרטי מקום (מזהים בלבד)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
ספריית מקומות, Maps JavaScript API:
id
photos
iOS:
GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos
שירות אינטרנט:
attributions
id
name
*
photos
* השדה name
מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID
. משתמשים ב-displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 USD לכל (0.00 USD ל-1,000) |
0.0 USD לכל (0.00 USD ל-1,000) |
0.0 USD לכל (0.00 USD ל-1,000) |
מק"ט: פרטי מקום (מיקום בלבד)
באמצעות מסכת שדות או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS
Place.Field.LOCATION
Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT
ספריית מקומות, Maps JavaScript API:
addressComponents
adrFormatAddress
formattedAddress
location
plusCode
types
viewport
iOS:
GMSPlacePropertyAddressComponents
GMSPlacePropertyFormattedAddress
GMSPlacePropertyCoordinate
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyViewport
שירות אינטרנט:
addressComponents
adrFormatAddress
formattedAddress
location
plusCode
shortFormattedAddress
types
viewport
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי המקום (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.BUSINESS_STATUS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET
ספריית מקומות, Maps JavaScript API:
accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes
iOS:
GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance
שירות אינטרנט:
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes
* השדה googleMapsLinks
נמצא בשלב תצוגה מקדימה לפני GA, ללא חיוב, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.
אם סשן של השלמה אוטומטית מסתיים בקריאה לפרטים של מקום שמבקשת כל שדה מ-מק"ט: פרטים של מקום (בסיסי, מתקדם או מועדף), החיוב על הקריאה מתבצע לפי מק"ט: פרטים של מקום (מועדף). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.0170 USD לכל (17.00 USD ל-1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי המקום (מתקדם)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
ספריית מקומות, 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
אם סשן של השלמה אוטומטית מסתיים בקריאה לפרטים של מקום שמבקשת כל שדה מ-מק"ט: פרטים של מקום (בסיסי, מתקדם או מועדף), החיוב על הקריאה מתבצע לפי מק"ט: פרטים של מקום (מועדף). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.020 USD לכל (20.00 USD ל-1,000) |
0.016 USD לכל (16.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: פרטי המקום (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה 'פרטי מקום (חדש)', אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
ספריית מקומות, 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
iOS:
GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout
שירות אינטרנט:
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
* חיפוש טקסט וחיפוש בקרבת מקום בלבד
אם סשן של השלמה אוטומטית מסתיים בקריאה לפרטים של מקום שמבקשת כל שדה מ-מק"ט: פרטים של מקום (בסיסי, מתקדם או מועדף), החיוב על הקריאה מתבצע לפי מק"ט: פרטים של מקום (מועדף). מידע נוסף זמין במאמר מק"ט: שימוש בסשן של השלמה אוטומטית.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.025 USD לכל (25.00 USD ל-1,000) |
0.020 USD לכל (20.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.ADDRESS
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_URL
Place.Field.LAT_LNG
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.ID
Place.Field.NAME
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
ספריית מקומות, Maps JavaScript API:
accessibilityOptions
addressComponents
adrFormatAddress
businessStatus
displayName
formattedAddress
googleMapsUri
iconBackgroundColor
id
location
photos
plusCode
svgIconMaskURI
types
utcOffsetMinutes
viewport
iOS:
GMSPlacePropertyAddressComponents
GMSPlacePropertyBusinessStatus
GMSPlacePropertyCoordinate
GMSPlacePropertyFormattedAddress
GMSPlacePropertyName
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyPhotos
GMSPlacePropertyPlaceID
GMSPlacePropertyPlusCode
GMSPlacePropertyTypes
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyViewport
GMSPlacePropertyWheelchairAccessibleEntrance
שירות אינטרנט:
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.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
* השדה places.googleMapsLinks
נמצא בשלב תצוגה מקדימה לפני השקה רגילה, ואין חיוב על השימוש במהלך התצוגה המקדימה. כלומר, החיוב הוא 0$.
** השדה places.name
מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID
. משתמשים ב-places.displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256 USD לכל (25.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (מתקדם)
באמצעות מסכת שדות או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
ספריית מקומות, Maps JavaScript API:
internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri
iOS:
GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite
שירות אינטרנט:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.035 USD לכל (35.00 USD ל-1,000) |
0.028$ לכל (28.00$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש בקרבת מקום (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש בקרבת מקום (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
ספריית מקומות, 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
iOS:
GMSPlacePropertyCurbsidePickup
GMSPlacePropertyDelivery
GMSPlacePropertyDineIn
GMSPlacePropertyEditorialSummary
GMSPlacePropertyReservable
GMSPlacePropertyReviews
GMSPlacePropertyServesBeer
GMSPlacePropertyServesBreakfast
GMSPlacePropertyServesBrunch
GMSPlacePropertyServesDinner
GMSPlacePropertyServesLunch
GMSPlacePropertyServesVegetarianFood
GMSPlacePropertyServesWine
GMSPlacePropertyTakeout
שירות אינטרנט:
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
* חיפוש טקסט וחיפוש בקרבת מקום בלבד
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.040 USD לכל (40.00 USD ל-1,000) |
0.032 USD לכל (32.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מזהה בלבד)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.DISPLAY_NAME
Place.Field.ID
Place.Field.RESOURCE_NAME
iOS:
GMSPlacePropertyPlaceID
GMSPlacePropertyName
ספריית מקומות, Maps JavaScript API:
id
שירות אינטרנט:
places.attributions
places.id
places.name
*
nextPageToken
* השדה places.name
מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID
. משתמשים ב-places.displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.0 USD לכל (0.00 USD ל-1,000) |
0.0 USD לכל (0.00 USD ל-1,000) |
0.0 USD לכל (0.00 USD ל-1,000) |
מק"ט: חיפוש טקסט (בסיסי)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ACCESSIBILITY_OPTIONS
Place.Field.ADDRESS_COMPONENTS
Place.Field.ADR_FORMAT_ADDRESS
Place.Field.BUSINESS_STATUS
Place.Field.FORMATTED_ADDRESS
Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL
Place.Field.LOCATION
Place.Field.PHOTO_METADATAS
Place.Field.PLUS_CODE
Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.SUB_DESTINATIONS
Place.Field.TYPES
Place.Field.UTC_OFFSET
Place.Field.VIEWPORT
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.primaryType
places.primaryTypeDisplayName
places.pureServiceAreaBusiness
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
* השדה places.googleMapsLinks
נמצא בשלב טרום-השקה (Preview) ואין חיוב, כלומר החיוב הוא 0 $על שימוש במהלך גרסת ה-Preview.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256 USD לכל (25.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מתקדם)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS:
GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours
GMSPlacePropertyPhoneNumber
GMSPlacePropertyPriceLevel
GMSPlacePropertyRating
GMSPlacePropertyOpeningHours
GMSPlacePropertyUserRatingsTotal
GMSPlacePropertyWebsite
שירות אינטרנט:
places.currentOpeningHours
places.currentSecondaryOpeningHours
places.internationalPhoneNumber
places.nationalPhoneNumber
places.priceLevel
places.priceRange
places.rating
places.regularOpeningHours
places.regularSecondaryOpeningHours
places.userRatingCount
places.websiteUri
ספריית מקומות, Maps JavaScript API:
internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.035 USD לכל (35.00 USD ל-1,000) |
0.028$ לכל (28.00$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: חיפוש טקסט (מועדף)
באמצעות מסכת שדה או רשימת שדות בבקשה של חיפוש טקסט (חדש), אפשר להגביל את התגובה רק לשדות שצוינו. המק"ט הזה מופעל כשמבקשים רק את השדות הבאים:
Android:
Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
iOS:
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
* חיפוש טקסט וחיפוש בקרבת מקום בלבד
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.040 USD לכל (40.00 USD ל-1,000) |
0.032 USD לכל (32.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Place Photo
על כל בקשה ל-API תחויבו במק"ט Place Photo.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"טים של מוצרים ב-Places
ממשקי ה-API ב-Places כוללים את Places API, Places SDK ל-Android, Places SDK ל-iOS, ספריית מקומות, Maps JavaScript API, Geocoding API, Geolocation API, Time Zone API ו-Elevation API.
מידע על סשנים של השלמה אוטומטית
סשן של השלמה אוטומטית כולל כמה בקשות להשלמה אוטומטית (כדי לאחזר הצעות למקום בזמן שהמשתמש מקלידים) ובקשת פרטים על מקומות אחת לכל היותר (כדי לאחזר פרטים על המקום שבחר המשתמש). אותו אסימון סשן מועבר להשלמה האוטומטית ולבקשה הבאה לקבלת פרטי המקום. סשן מתחיל עם הבקשה הראשונה להשלמה אוטומטית (בדרך כלל כשהמשתמש מתחיל להקליד). קריאה ל-Places Details מתבצעת כשהמשתמש בוחר באחת מההצעות של ההשלמה האוטומטית. אם המשתמש לא בוחר הצעה, לא מתבצעת קריאה ל-Places Details.
אחרי שמשתמש בוחר מקום (כלומר, אחרי שמתבצעת קריאה ל-Places Details), צריך להתחיל סשן חדש באמצעות אסימון סשן חדש.
אפשר ליצור סשנים של השלמה אוטומטית מהממשקי ה-API הבאים:
- שירות ההשלמה האוטומטית של מקומות ב-Places API או שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API. צריך לתכנן את האפליקציה כך שתספק אסימוני סשן (יכול להיות שתצטרכו לשנות את הקוד הקיים).
- הווידג'ט של השלמה אוטומטית של Maps JavaScript API. החיוב על בסיס סשנים מופעל באופן אוטומטי בווידג'טים האלה, בלי צורך לשנות את הקוד.
אסימון סשן תקף לסשן משתמש אחד, ואסור להשתמש בו ביותר מסשן משתמש אחד. אם משתמשים שוב באסימון סשן, הסשן נחשב לא חוקי והבקשות מחוייבות כאילו לא סופק אסימון סשן.
הבקשות להשלמה אוטומטית והבקשות לפרטים של מקומות באמצעות סשנים מחויבות לפי מק"טים שונים.
מידע על מק"טים של נתוני מקומות
שלושת המק"טים של נתוני המקומות הם: נתונים בסיסיים, פרטים ליצירת קשר ונתוני אטמוספרה.מק"ט אחד או יותר של נתונים מופעל עבור:
- Android: כל בקשה אל
fetchPlace()
אוfindCurrentPlace()
- iOS: כל קריאה ל-
fetchPlaceFromPlaceID:
או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- שירות אינטרנט: כל בקשה ל-Places בהתאם לשדות שצוינו בבקשה
תמיד תחויבו על מק"טים של נתונים בנוסף למק"ט הבסיס של הבקשה שהפעילה אותם. לדוגמה, בקשה לפרטים על מקום שכוללת שדות של נתונים בסיסיים תחויב גם לפי המק"ט של נתונים בסיסיים וגם לפי המק"ט של פרטים על מקום.
בשירות האינטרנט, הבקשות האלה של Places API מאפשרות לכם לציין את שדות הנתונים שיוחזרו:
בשירות האינטרנט, הקריאות האלה ל-Places APIs לא תומכות בתיוג של השדות שיוחזרו. הקריאות האלה תמיד מחזירות את כל נתוני Places, ומחויבים שלושת המק"טים של נתוני Places בנוסף לחיוב על כל בקשת API:
מק"ט: נתונים בסיסיים
באמצעות הפרמטר fields בבקשה לפרטים של מקום או בבקשה לחיפוש מקום, אפשר להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה בסיסי כלולים בעלויות הבסיסית של הבקשה ל-Places ולא גוררים חיוב נוסף. המק"ט Basic Data מופעל כשמתבצעת בקשה לאחד מהשדות הבאים:
-
Android:
Place.Field.ACCESSIBILITY_OPTIONS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.DISPLAY_NAME
,Place.Field.FORMATTED_ADDRESS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_MASK_URL
,Place.Field.ID
,Place.Field.LOCATION
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
אוPlace.Field.UTC_OFFSET
. -
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
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
עלות הבקשה להצגת המלונות ב-Google + 0.00 USD |
מק"ט: פרטי איש קשר
אפשר להגביל את התשובה רק לשדות שצוינו באמצעות הפרמטר fields בבקשה לפרטים של מקום או ל'חיפוש מקום' בשירותי אינטרנט, או באמצעות מערך של Place.Field
ב-Android או ב-iOS. שדות בקטגוריה איש קשר יגרמו לחיוב נוסף. המק"ט פרטים ליצירת קשר מופעל כשמבקשים את אחד מהשדות הבאים:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.INTERNATIONAL_PHONE_NUMBER
,Place.Field.OPENING_HOURS
,Place.Field.SECONDARY_OPENING_HOURS
אוPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
אוGMSPlaceFieldWebsite
-
שירות אינטרנט:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
אוwebsite
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
עלות הבקשה ל-Places + 0.003$ לכל בקשה (+ 3.00$ לכל 1,000 בקשות) |
עלות הבקשה ל-Places + 0.0024 דולר ארה"ב לכל בקשה (+ 2.40 דולר ארה"ב ל-1,000 בקשות) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: נתוני אווירה
באמצעות הפרמטר fields בבקשה לקבלת פרטי מקום או בבקשה לחיפוש מקום, אפשר להגביל את התשובה רק לשדות שצוינו. שדות בקטגוריה Atmosphere יגרמו לחיוב נוסף. המק"ט Atmosphere Data מופעל כשמבקשים את אחד מהשדות הבאים:
- Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,Place.Field.EDITORIAL_SUMMARY
,Place.Field.DINE_IN
,Place.Field.PRICE_LEVEL
,Place.Field.RATING
,Place.Field.RESERVABLE
,Place.Field.SERVES_BEER
,Place.Field.SERVES_BREAKFAST
,Place.Field.SERVES_BRUNCH
,Place.Field.SERVES_DINNER
,Place.Field.SERVES_LUNCH
,Place.Field.SERVES_VEGETARIAN_FOOD
,Place.Field.SERVES_WINE
,Place.Field.TAKEOUT
אוPlace.Field.USER_RATING_COUNT
- iOS:
GMSPlaceFieldPriceLevel
, GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
, GMSPlaceFieldTakeout
, GMSPlaceFieldDelivery
, GMSPlaceFieldDineIn
, GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
, GMSPlaceFieldServesLunch
, GMSPlaceFieldServesDinner
, GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
, GMSPlaceFieldServesBrunch
אוGMSPlaceFieldServesVegetarianFood
. - JavaScript: מידע נוסף זמין בקטע שדות (פרטי המקום)
- שירות אינטרנט:
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
.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
עלות הבקשה להוספת מקום + 0.005$ לכל בקשה (+ 5.00$ ל-1,000 בקשות) |
עלות הבקשה ל-Places + 0.004$ לכל בקשה (+ 4.00$ ל-1,000 בקשות) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: השלמה אוטומטית – לכל בקשה
העלויות של המק"ט Autocomplete – Per Request חלות על כל הקריאות או הבקשות האלה שלא כוללות אסימון סשן:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: השירות של מילוי אוטומטי של מקומות ב-Maps JavaScript API
- שירות אינטרנט: שירות ההשלמה האוטומטית של מקומות ב-Places API
גם על שיחות שמבוצעות מסשן לא חוקי של השלמה אוטומטית (לדוגמה, סשן שבו נעשה שימוש חוזר באסימון סשן) מחויב המק"ט 'השלמה אוטומטית – לכל בקשה'.
אם יתבצעו קריאות מסשן השלמה אוטומטית לא חוקי, יכול להיות שתחויבו על בקשות השלמה אוטומטית מ-ווידג'ט השלמה אוטומטית של מקומות ב-Maps JavaScript API במחיר של מק"ט 'השלמה אוטומטית – לכל בקשה'. מצב כזה יכול לקרות כשמשתמש מקלידים כמה כתובות שונות או מעתיקים/מדביקים כתובות שונות לווידג'ט, ולא תמיד בוחרים תחזית להשלמה אוטומטית.
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1,000) |
0.00227 USD לכל (2.27 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט Autocomplete without Place Details – Per Session מחויב על סשן של השלמה אוטומטית שלא כולל בקשה לפרטים על מקום (במהלך כמה דקות מתחילת הסשן).
טווח נפח חודשי (מחיר לכל סשן) |
||
---|---|---|
0.017 USD לכל (17.00 USD ל-1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
דוגמה
אם האפליקציה שלכם מבצעת את שתי הקריאות האלה בסשן אחד:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
שירות אינטרנט
- בקשה להשלמה אוטומטית של מקום (input=”par”, session_token: XYZ)
- בקשה להשלמה אוטומטית של מקום (input=”paris”, session_token: XYZ)
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל סשן (המחיר מתחיל ב-0.017$ לכל סשן)
מק"ט: השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן
החיוב על המק"ט השלמה אוטומטית (כלולה בפרטים של מקומות) – לכל סשן מתייחס לסשן השלמה אוטומטית שכולל אחד מהאירועים הבאים:
- Android: קריאה ל-
fetchPlace()
- iOS: קריאה ל-
fetchPlaceFromPlaceID:
- שירות אינטרנט: בקשה לקבלת פרטי מקום
הבקשה להשלמה האוטומטית זמינה ללא תשלום, והקריאה הבאה לקבלת פרטי המקום מחויבת לפי המחירון הרגיל של פרטי המקום.
בקשה לפרטים על מקום יוצרת מק"טים של נתונים (Basic, Contact ו/או Atmosphere) בהתאם לשדות שצוינו בבקשה.
אם לא מציינים שדות בבקשה לפרטים על המקום, כל המק"טים של נתונים מופעלים (Basic, Contact ו-Atmosphere).
בקשות לרענון מזהה של פרטי מקום (בקשות שמציינות רק את השדה place_id
) במהלך סשן של השלמה אוטומטית מחוייבות כ-SKU: Autocomplete without Place Details – Per Session.
טווח נפח חודשי (מחיר לכל סשן) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
אם האפליקציה שלכם מבצעת את שלוש הקריאות הבאות בסשן אחד:
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)
בחשבון יופיעו המק"טים האלה (כשמציגים את החשבון לפי מק"ט):
- השלמה אוטומטית (כלולה ב'פרטי המקום') – לכל סשן (החיוב הוא 0.00$)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה
המחיר של המק"ט השלמה אוטומטית של שאילתות – לכל בקשה מחויב על כל בקשה ל:
- JavaScript:
שירות ההשלמה האוטומטית של מקומות ב-Maps JavaScript API (
getQueryPredictions()
) והשימוש ב ווידג'ט SearchBox של Maps JavaScript API (בקשות להשלמה אוטומטית של שאילתות נוצרות בזמן שהמשתמש מקלידים). - שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות ב-Places API
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1,000) |
0.00227 USD לכל (2.27 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
אין תמיכה בתמחור לפי סשן של השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. על קריאות חוזרות ל-Places Details תחויבו לפי התמחור הרגיל של Places Details.
מק"ט: פרטי מקומות
החיוב על שיחות לקבלת פרטי מקומות מתבצע באופן הבא:
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 USD לכל (17.00 USD ל-1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
המק"ט Places Details נוצר מהממשקי ה-API הבאים:
- Android: Places SDK ל-Android
(
fetchPlace()
) - iOS: Places SDK ל-iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
שירות פרטי המקומות של Maps JavaScript API (
getDetails
) - JavaScript:
ווידג'ט של מילוי אוטומטי של מקומות ב-Maps JavaScript API (
getPlace
) - JavaScript:
ווידג'ט של תיבת חיפוש מקומות ב-Maps JavaScript API: ה-method
getPlaces()
אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדיל), כפי שמוצג כאן:בתוצאות של הווידג'ט של תיבת החיפוש, אחרי שמקלידים 'פיצה' בתיבת החיפוש, רואים שלצד Pizza Autentico מופיע סמל סיכה, שמציין שמדובר בתוצאת חיפוש של מקום (ולא בשאילתה). - שירות אינטרנט: שירות פרטי המקומות של Places API
כשמשתמשים ב-API ובשירותים של האינטרנט, מתבצע חיוב על המק"ט של פרטי המקום גם אם סיפקת אסימון סשן וגם אם לא.
קריאה או בקשה לפרטים של מקום יוצרות גם מק"טים של נתונים (Basic, Contact ו/או Atmosphere), בהתאם לשדות שצוינו בקריאה או בבקשה. אם לא מציינים אף שדה בקריאה או בבקשה לקבלת פרטי המקום, מופעלים כל המק"טים של הנתונים, ותחויבו על הקריאה או הבקשה לקבלת פרטי המקום בתוספת העלות של כל הנתונים.
דוגמאות
- מבצעים את אחת מהפעולות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()
ב-Android או לפונקציהfetchPlaceFromPlaceID:
ב-iOS, ומציינים רק את השדהADDRESS
- Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים רק את שדה הכתובת:
getPlaceDetails(fields: formatted_address)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
- נייד: קוראים לפונקציה
- מבצעים את אחת מהפעולות הבאות:
- נייד: קוראים לפונקציה
fetchPlace()
ב-Android או לפונקציהfetchPlaceFromPlaceID:
ב-iOS, ומציינים רק את השדהPHONE_NUMBER
- שירות או ממשק API לאינטרנט: שולחים בקשה לפרטים של מקום ומציינים את השדה של מספר הטלפון:
getPlaceDetails(fields: formatted_phone_number)
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נייד: קוראים לפונקציה
- מבצעים את אחת מהפעולות הבאות:
- נייד: מחייגים למספר
fetchPlace()
ב-Android או למספרfetchPlaceFromPlaceID:
ב-iOS ומציינים את כל השדות - Web API או שירות: שולחים בקשה לקבלת פרטי מקום ומציינים את כל השדות (סוג הבקשה הזה הוא ברירת המחדל אם לא מציינים שדות):
getPlaceDetails()
.
- פרטי המקום (המחיר מתחיל ב-0.017$ לסשן)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)
- נייד: מחייגים למספר
מק"ט: פרטי מקומות – רענון מזהה
אפשר להשתמש בבקשה Place Details כדי לחדש מזהים לא תקינים של מקומות. בקשות מהסוגים האלה זמינות ללא תשלום.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לקבלת פרטי מקום ומציינים רק את השדה place id: getPlaceDetails(fields: place_id)
.
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- פרטי מקומות – רענון מזהה (החיוב הוא 0.00$)
מק"ט: חיפוש מקום
Find Place מחויב על בקשה לחיפוש מקום.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 USD לכל (17.00 USD ל-1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש מקומות יוצרות גם מק"טים של נתונים (בסיסי, פרטים ליצירת קשר ו/או אווירה), בהתאם לשדות שצוינו בבקשה. בדומה לבקשות לפרטים של מקומות, אפשר להשתמש בפרמטר fields בבקשה לאיתור מקום כדי להגביל את התגובה רק לשדות שצוינו. אתם מחויבים על הבקשה לחיפוש מקום ועל הנתונים שביקשת. כברירת מחדל, אם לא מבקשים שדות NO, מוחזרים רק מזהה המקום, כך שלא נצברים חיובים נוספים על נתונים.
דוגמאות
- שולחים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת:
FindPlace(fields: formatted_address)
. המק"טים האלה יופיעו בחשבון (כש מציגים את החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- שולחים בקשה לחיפוש מקום ומציינים את השדה של מספר הטלפון:
FindPlace(fields: formatted_phone_number)
. המק"טים האלה יופיעו בחשבון (כש מציגים את החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- שולחים בקשה לחיפוש מקום ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים:
FindPlace(fields: formatted_address, opening_hours, price_level)
. בחשבון יופיעו המק"טים האלה (כש מציגים את החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל ב-0.017$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: חיפוש מקום – מזהה בלבד
החיוב על חיפוש מקום – מזהה בלבד מתייחס לבקשות חיפוש מקום שבהן מצוין רק מזהה המקום שצריך להחזיר. כברירת מחדל, אם לא מציינים שדות בבקשה Find Place, רק מזהה המקום מוחזר.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לחיפוש מקום ומציינים רק את השדה place_id
: FindPlace(fields: place_id)
.
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- חיפוש מקום – מזהה בלבד (החיוב הוא 0.00$)
מק"ט: Find Current Place
חיפוש המיקום הנוכחי מחויב על שיחות ל-findCurrentPlace()
(ב-Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(ב-iOS).
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.030 USD לכל (30.00 USD ל-1,000) |
0.024 דולר ארה"ב לכל (24.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
קריאות ל-findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) יוצרות גם מק"טים של נתונים (Basic, Contact ו/או Atmosphere), בהתאם לשדות שצוינו בקריאה.
מציינים שדות נתונים כדי להגביל את התגובה לשדות האלה בלבד. אתם מחויבים על הקריאה ל-Find Current Place ועל הנתונים המבוקשים.
דוגמאות
- קוראים ל-
findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ומציינים רק את השדהADDRESS
. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):- חיפוש המיקום הנוכחי (המחיר מתחיל ב-0.030$ USD לבקשה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- קוראים ל-
findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ומציינים את השדהPHONE_NUMBER
. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):- חיפוש המיקום הנוכחי (המחיר מתחיל ב-0.030$ USD לבקשה)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- קוראים ל-
findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):- חיפוש המיקום הנוכחי (המחיר מתחיל ב-0.030$ USD לבקשה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: מקומות – חיפוש בקרבת מקום
ב-Places – חיפוש בקרבת מקום, החיוב מתבצע על בקשות ל
שירות חיפוש מקומות בקרבת מקום של Maps JavaScript API (nearbySearch()
) או ל
שירות חיפוש בקרבת מקום של Places API.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256 USD לכל (25.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש בקרבת מקום מחזירות רשימה של מקומות, אבל אין תמיכה בקביעה אילו שדות יוחזרו. בקשות לחיפוש בקרבת מקום מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשה לחיפוש בקרבת מקום החל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (נתונים בסיסיים, פרטים ליצירת קשר ונתוני אטמוספרה).
דוגמה
שולחים בקשה לחיפוש בקרבת מקום, כמו NearbySearch (San Francisco, 100 meters)
.
בחשבון יופיעו המק"טים האלה (כשמציגים את החשבון לפי מק"ט):
- מקום – חיפוש בקרבת מקום (המחיר מתחיל ב-0.032$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספירה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: מקומות – חיפוש טקסט
ב-Places – חיפוש טקסט תחויבו על בקשות ל
שירות חיפוש טקסט של מקומות ב-Maps JavaScript API (textSearch()
) או ל
שירות חיפוש טקסט של Places API.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256 USD לכל (25.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל אין תמיכה בציינה של השדות שיוחזרו. בקשות לחיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשת חיפוש טקסט החל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (נתונים בסיסיים, נתוני אנשי קשר ונתוני אטמוספרה).
המק"ט 'מיקום – חיפוש טקסט' נוצר גם על ידי השיטה getPlaces()
של
הווידג'ט Place SearchBox של ממשק API של JavaScript במפות Google, אחרי שהמשתמש בוחר שאילתה למיקום (סמל: זכוכית מגדלת), לא תוצאה (סמל: סיכה), כפי שמוצג כאן:

דוגמה
שולחים בקשה לחיפוש טקסט, כמו TextSearch(123 Main Street)
. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):
- מקום – חיפוש טקסט (המחיר מתחיל ב-0.032$ לשיחה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: תמונה של מקומות
מק"ט של תמונה ב-Places מחויב על:
- Android: קריאות אל
fetchPhoto()
- iOS: קריאות אל
loadPlacePhoto:
- JavaScript: לספריית המקומות, שירות התמונות של המקומות של Maps JavaScript API כשמבקשים נתונים מכתובות ה-URL שמוחזרות על ידי
PlacePhoto.getUrl()
כדי לטעון נתוני פיקסלים של תמונות - שירות אינטרנט: בקשות לשירות התמונות של Places API
בשירות JavaScript, קריאה ל-method PlacePhoto.getUrl()
לא גורמת לחיוב עד שמשתמשים בכתובת ה-URL בפועל כדי לקבל נתוני פיקסלים.
טווח נפח שיחות חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 USD לכל (7.00 USD ל-1,000) |
0.0056 USD לכל (5.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: המרת כתובות לקואורדינטות (geocoding)
מק"ט של Geocoding מחויב על בקשות לשירות המרת כתובות לקואורדינטות (geocoding) של Maps JavaScript API או ל-Geocoding API.
ב-JavaScript, השיטה
Geocoder.geocode()
מפעילה את הבקשה לשירות המרת כתובות לקואורדינטות (geocoding).
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: מיקום גיאוגרפי
על בקשות ל-Geolocation API תחויבו לפי מק"ט של Geolocation.
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Map Tiles API: 2D Map Tiles
בקשה ל-Map Tiles API לאחזור משבצות של מפת כבישים, לוויין או פני שטח. חשוב לזכור שלא מתבצע חיוב על בקשות לקבלת אסימון סשן ומידע על חלון תצוגה.
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001 ומעלה | |||
0.0006 דולר ארה"ב לכל (0.60 דולר ארה"ב ל-1,000) |
0.00048 דולר ארה"ב לכל (0.48 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Map Tiles API: Street View Tiles
בקשה ל-Map Tiles API לאחזור משבצות של Street View, תמונות ממוזערות של Street View או מזהי Pano של Street View. חשוב לזכור שלא מתבצעת חיוב על בקשות של אסימון סשן ומטא-נתונים של Street View.
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001 ומעלה | |||
0.002 USD לכל (2.00 USD ל-1,000) |
0.0016 USD לכל (1.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Map Tiles API: Photorealistic 3D Tiles
בקשה ל-Map Tiles API לאחזור של משבצות Root תלת-ממדיות.
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0.006 USD לכל (6.00 USD ל-1,000) |
0.0051 דולר ארה"ב לכל (5.10 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: אזור זמן
על בקשות ל-Time Zone API תחויבו לפי מק"ט של Time Zone.
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Elevation
מק"ט Elevation מחויב על בקשות לשירות הגובה של Maps JavaScript API או ל-Elevation API.
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: בקשה לאימות כתובת
בקשה ל-method validateAddress (REST) ול-method ValidateAddress (gRPC) של Address Validation API.
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.017 USD לכל (17.00 USD ל-1,000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Address Validation Preferred
האפשרות 'העדפה לאימות כתובות' פועלת עם נקודת הקצה השלמה אוטומטית (חדש) של Places API כשמשתמשים בה בסשנים שמסתיימים בקריאה ל-Address Validation API. באופן ספציפי, סשנים שמשתמשים בהשלמה האוטומטית (חדש) ומסתיימים בבקשה ל-validateAddress (REST) או ל-ValidateAddress (gRPC) נכללים במודל התמחור הזה.
למידע נוסף על התמחור ועל השימוש בסשנים של השלמה אוטומטית (חדש) עם Places API, תוכלו לעיין במדריכים הבאים במסמכי העזרה של Places API:
כשמשתמשים באפשרות 'העדפת אימות כתובות' בסוף סשן של השלמה אוטומטית (חדש), החיוב מתבצע באופן הבא:
טווח נפח חודשי (מחיר לכל בקשה) |
||
---|---|---|
0.025 USD לכל (25.00 USD ל-1,000) |
0.020 USD לכל (20.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"טים של מוצרים בסביבה
ממשקי ה-API בסביבה כוללים את: Air Quality API, Pollen API ו-Solar API.
מק"ט: שימוש באיכות האוויר
המק"ט הזה רלוונטי לשיטות ולנקודות הקצה הבאות:
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0.005$ לכל (5.00$ לכל 1,000) |
0.004 דולר ארה"ב לכל (4.00 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Pollen
המק"ט הזה רלוונטי לנקודות הקצה או לשיטות הבאות:
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.008 USD לכל (8.00 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Solar API Building Insights
בקשה ל-buildingInsights.
טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0.01 USD לכל (10.00 USD ל-1,000) |
0.005$ לכל (5.00$ לכל 1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: שכבות נתונים של Solar API
בקשה ל-dataLayers.
גישה לכמה כתובות URL של תמונות מאותה בקשה לא יוצרת שאילתות נוספות לחיוב.טווח נפח חודשי (מחיר לכל בקשה) |
|||||
---|---|---|---|---|---|
0.075 USD לכל (75.00 USD ל-1,000) |
0.0375$ לכל (37.50$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט של ניווט
ערכות Navigation SDK כוללות את: Navigation SDK ל-Android ו-Navigation SDK ל-iOS.
מק"ט: בקשת ניווט
כל יעד שמתבקש באמצעות Navigation SDK מחויב כיחידה של מק"ט מסוג בקשת ניווט. המחיר לכל יחידה של מק"ט נקבע לפי נפח השיחות הכולל בחודש של המק"ט:
טווח נפח חודשי (מחיר ליעד) |
||
---|---|---|
1 עד 1,000 | 1,001 עד 4,200,000 | 4,200,000 ומעלה |
ללא חיוב | 0.05 USD | 0.0395 USD |
שיטות לבקשת מסלול
אפשר לשלוח בקשות ליצירת מסלולים ל-Navigation SDK באמצעות הקריאה ל-methods הבאים:
Android
- setDestination (יעד של ציון דרך)
- setDestination (יעד של ציון דרך, אפשרויות של RoutingOptions)
- setDestination (Waypoint destination, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (List<Waypoint> destinations, RoutingOptions options)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [Deprecated] setDestinations (List<Waypoint> destinations, String routeToken)
iOS
חשוב לזכור שקריאה ל-method אחת יכולה להכיל עד 25 יעדים, והעלות של כל קריאה מחושבת על ידי הכפלת מספר היעדים במחיר ליחידה של מק"ט.