בקטע הזה מפורטים המק"טים שמוגדרים למוצרי הליבה של פלטפורמת מפות 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.
טווח נפח חודשי (מחיר לכל טעינת MAP) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
לכל מופע של אובייקט מפה של Google במצב טעינה מהירה באפליקציה לנייד של Maps SDK ל-Android, נצברת טעינה אחת של מפה. המפות נוצרות באמצעות מכונות של הכיתות MapFragment
, SupportMapFragment
או MapView
. טעינת מפה נספרת בכל פעם שמפעילים את השיטה הרלוונטית onCreate()
.
מק"ט: מפות דינמיות לנייד
אובייקט של מפת Google, שלא נטען עם מזהה מפה, באפליקציה לנייד של SDK של מפות ל-Android או של SDK של מפות ל-iOS.
טווח נפח חודשי (מחיר לכל טעינת MAP) |
||
---|---|---|
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.
טווח נפח חודשי (מחיר לכל טעינת MAP) |
||
---|---|---|
0.002 USD לכל (2.00 USD ל-1,000) |
0.0016 USD לכל (1.60 USD ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Dynamic Maps
אפליקציה שמציגה מפה שנטענת עם או בלי מזהה מפה באמצעות Maps JavaScript API, או מפה שנטענת עם מזהה מפה באמצעות Maps SDK for Android או Maps SDK for iOS.
טווח נפח חודשי (מחיר לכל טעינת MAP) |
||
---|---|---|
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) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: Street View דינמי
מעכשיו, טעינה של מפות ותמונות פנורמיות של Street View כרוכה בתשלום בנפרד. החיוב על תצוגת Street View דינמית מתבצע על כל יצירה של אובייקט פנורמה באפליקציה של Maps JavaScript API, Maps SDK for Android או Maps SDK for iOS.
טווח נפח חודשי (מחיר לכל PANORAMA) |
||
---|---|---|
0.014$ לכל (14.00$ ל-1,000) |
0.0112 USD לכל (11.20 USD ל-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 דולר ארה"ב לכל (12.80 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
החיוב מתבצע רק על קריאות אל
lookupVideo
שמחזירות כתובות URL. תשובה אחת מוצלחת של lookupVideo
עשויה להחזיר כמה כתובות URL, כל אחת ברזולוציה או בכיוון שונים, אבל היא נחשבת לאירוע אחד לחיוב בלבד. חשוב לזכור שהתמחור לא תלוי בכך שמשתמשי הקצה צפו בפועל בכתובות ה-URL האלה.
מק"טים של מוצרים במסלולים
ממשקי ה-API ב-Routes כוללים את: Directions API, Distance Matrix API ו-Roads API.
מק"ט: מסלול הגעה
בקשה ל שירות המסלול של ממשק ה-API של JavaScript במפות Google (לא כולל בקשות שמפעילות את המק"ט לחיוב 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 או ל- שירות Distance Matrix של 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 דולר ארה"ב לכל (8.00 דולר ארה"ב ל-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$ לכל (14.00$ ל-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). לאחר מכן, כל הבקשות להשלמה אוטומטית (חדשות) יחויבו באמצעות המק"ט Autocomplete Requests.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.00283$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: שימוש בסשן של השלמה אוטומטית
מק"ט של שימוש בסשן של השלמה אוטומטית מחויב על כל בקשה ל-API של השלמה אוטומטית (חדש) שכוללת אסימון סשן.
המק"ט הזה מחויב בתרחישים הבאים:
סשן ההשלמה האוטומטית הסתיים על ידי קריאה ל-SKU: פרטי מקום (מיקום בלבד):
- כל בקשה להשלמה אוטומטית (חדשה), עד 12 בקשות, מחויבת באמצעות המק"ט Autocomplete Requests.
- כל בקשה נוספת של Autocomplete (חדש) מחויבת באמצעות המק"ט SKU: Autocomplete Session Usage.
סשן ההשלמה האוטומטית הסתיים בקריאה ל-SKU: Place Details (Basic, Advanced, or Preferred).
קריאה ל-Place Details שמבקשת כל שדה מ-SKU: Place Details (Basic, Advanced או Preferred) מחויבת לפי SKU: Place Details (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
,
GMSPlacePropertyName
,
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
,
GMSPlacePropertyUTCOffsetMinutes
,
GMSPlacePropertyWheelchairAccessibleEntrance
שירות אינטרנט:
accessibilityOptions
,
businessStatus
,
containingPlaces
,
displayName
,
googleMapsLinks
*,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
pureServiceAreaBusiness
,
subDestinations
,
utcOffsetMinutes
* השדה googleMapsLinks
נמצא בשלב תצוגה מקדימה לפני GA, והוא ללא חיוב, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.
אם סשן של השלמה אוטומטית מסתיים בקריאה לפרטים של מקום שמבקשת כל שדה מ-מק"ט: פרטים של מקום (בסיסי, מתקדם או מועדף), הקריאה מחויבת לפי מק"ט: פרטים של מקום (מועדף). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.0170 דולר ארה"ב לכל (17.00 דולר ארה"ב ל-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
נמצא בשלב תצוגה מקדימה לפני GA, והוא ללא חיוב, כלומר החיוב הוא 0 $על שימוש במהלך התצוגה המקדימה.
** השדה places.name
מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID
. מקישים על places.displayName
כדי לגשת לשם הטקסט של המקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.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
שירות אינטרנט:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.priceRange
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.035$ לכל (35.00$ ל-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
נמצא בשלב תצוגה מקדימה לפני GA, ואין חיוב על השימוש במהלך התצוגה המקדימה, כלומר החיוב הוא 0$.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.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
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$ לכל (35.00$ ל-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 בהתאם לשדות שצוינו בבקשה
תמיד תחויבו על מק"טים של נתונים בנוסף למק"ט הבסיס של הבקשה שהפעילה אותם. לדוגמה, בקשה לפרטים על מקום שכוללת שדות של נתונים בסיסיים תחויב גם לפי המק"ט של נתונים בסיסיים וגם לפי המק"ט של פרטים על מקום.
בשירות האינטרנט, הקריאות האלה לממשקי API של Places תומכות בהגדרת שדות הנתונים שיוחזר:
בשירות האינטרנט, הקריאות ל-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$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל סשן
המק"ט Autocomplete without Place Details – Per Session מחויב על סשן של השלמה אוטומטית שלא כולל בקשה לפרטים על מקום (בתוך כמה דקות מתחילת הסשן).
טווח נפח חודשי (מחיר לכל סשן) |
||
---|---|---|
0.017$ לכל (17.00$ ל-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$ לכל (2.83$ ל-1,000) |
0.00227 דולר ארה"ב לכל (2.27 דולר ארה"ב ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
אין תמיכה בתמחור לפי סשן של השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. על קריאות חוזרות ל-Places Details תחויבו לפי התמחור הרגיל של Places Details.
מק"ט: פרטי מקומות
החיוב על שיחות לקבלת פרטי מקומות מתבצע באופן הבא:
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.017$ לכל (17.00$ ל-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()
אחרי שהמשתמש בוחר תוצאת חיפוש של מקום (סמל הסיכה), *לא* שאילתה (סמל המגדיל), כפי שמוצג כאן: - שירות אינטרנט: שירות פרטי המקומות של 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$ לבקשה)
- נייד: מחייגים למספר
מק"ט: פרטי מקומות – רענון מזהה
אפשר להשתמש בבקשה 'פרטי מקום' כדי לרענן מזהים של מקומות לא עדכניים. הבקשות האלה זמינות ללא תשלום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשה לקבלת פרטי מקום ומציינים רק את השדה 'מזהה מקום':
getPlaceDetails(fields: place_id)
.
המק"ט הזה יופיע בחשבון (כשמציגים את החשבון לפי מק"ט):
- פרטי מקומות – רענון מזהה (החיוב הוא 0.00$)
מק"ט: חיפוש מקום
חיפוש מקום מחויב על בקשה לחיפוש מקום.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.017$ לכל (17.00$ ל-1,000) |
0.0136$ לכל (13.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות ל'חיפוש מקום' יוצרות גם מק"טים של נתונים (בסיסי, איש קשר ו/או אווירה), בהתאם לשדות שצוינו בבקשה. בדומה לבקשות לפרטים של מקומות, אפשר להשתמש בפרמטר fields בבקשה לחיפוש מקום כדי להגביל את התגובה רק לשדות שצוינו. אתם מחויבים על הבקשה לחיפוש מקום ועל הנתונים שביקשת. כברירת מחדל, אם לא מבקשים אף שדה, המערכת מחזירה רק את מזהה המקום, כך שלא נצברות חיובים נוספים על נתונים.
דוגמאות
- שולחים בקשה לחיפוש מקום ומציינים רק את שדה הכתובת:
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
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$ לבקשה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- קוראים ל-
findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ומציינים את השדהPHONE_NUMBER
. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):- חיפוש המיקום הנוכחי (המחיר מתחיל ב-0.030$ לבקשה)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- קוראים ל-
findCurrentPlace()
(Android) או ל-findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) ומציינים שדות מכל שלוש הקטגוריות של סוגי הנתונים. המק"טים האלה יופיעו בחשבון (כשמציגים את החשבון לפי מק"ט):- חיפוש המיקום הנוכחי (המחיר מתחיל ב-0.030$ לבקשה)
- נתונים בסיסיים (החיוב הוא 0.00$)
- פרטי איש קשר (המחיר מתחיל ב-0.003$ לבקשה)
- נתוני אטמוספרה (המחיר מתחיל ב-0.005$ לבקשה)
מק"ט: מקומות – חיפוש בקרבת מקום
ב-Places – חיפוש בקרבת מקום, החיוב הוא על בקשות ל
שירות חיפוש מקומות בקרבת מקום של Maps JavaScript API (nearbySearch()
) או ל
שירות חיפוש בקרבת מקום של Places API.
טווח נפח חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 USD לכל (32.00 USD ל-1,000) |
0.0256$ לכל (25.60$ ל-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$ לכל (25.60$ ל-1,000) |
פנייה למחלקת המכירות לקבלת מחיר נפח |
בקשות לחיפוש טקסט מחזירות רשימה של מקומות, אבל לא תומכות בתיאור של השדות שיוחזרו. בקשות לחיפוש טקסט מחזירות קבוצת משנה של שדות הנתונים הנתמכים. אתם מחויבים על בקשת חיפוש טקסט החל מ-0.032$ לכל בקשה, וגם על כל המק"טים של סוגי הנתונים (Basic Data, Contact Data ו-Atmosphere Data).
המק"ט 'מיקום – חיפוש טקסט' נוצר גם על ידי השיטה 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 USD לכל (0.60 USD ל-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$ לכל (17.00$ ל-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$ לכל (10.00$ ל-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 יעדים, והעלות של כל קריאה מחושבת על ידי הכפלת מספר היעדים במחיר ליחידה של מק"ט.