ה-API של 'מקומות' משתמש במודל תמחור מסוג 'תשלום לפי שימוש'. בקשות API של מקומות Google יוצרות קריאות לכל אחד ממק"טים מרובים. בנוסף לתנאים ולהגבלות הכלליים של Google, קיימות מגבלות שימוש ספציפיות ל-API של 'מקומות'. ניהול העלויות והשימוש באמצעות הכלים הזמינים במסוף Google Cloud.
איך מחויב ה-API של מקומות Google
ה-API של 'מקומות' משתמש במודל תמחור מסוג 'תשלום לפי שימוש'. ממשקי API ו-SDK של הפלטפורמה של מפות Google מחויבים באמצעות מק"ט. מתבצע מעקב אחר השימוש לכל מק"ט, ולכל API או SDK יכול להיות יותר ממק"ט של מוצר אחד. העלות מחושבת לפי
כדי לחשב את עלות השימוש לכל API או SDK, כדאי להשתמש במחשבון התמחור והשימוש. עבור מק"טים מתאימים של Google Maps Platform, סכום של $200 USD בפלטפורמה של מפות Google זמין מדי חודש לכל חשבון לחיוב. הזיכוי הזה מופיע באופן אוטומטי במק"ט 1 באופן אוטומטי.
תמחור לממשק API של מקומות Google
מידע על סשנים של השלמה אוטומטית
סשן בהשלמה אוטומטית כולל כמה בקשות להשלמה אוטומטית (כדי לאחזר הצעות לגבי מקום מסוים בזמן שהמשתמש מקליד), ולכל היותר בקשת 'פרטי מקום' (כדי לאחזר פרטים על המקום שהמשתמש בחר). אותו אסימון סשן מועבר להשלמה האוטומטית ולבקשת פירוט המקום הבאה. סשן מתחיל בבקשה הראשונה להשלמה אוטומטית (בדרך כלל מתרחשת כשהמשתמש מתחיל להקליד). מתבצעת קריאה לפרטים של מקומות כאשר המשתמש בוחר באחת מההצעות של ההשלמה האוטומטית. אם משתמש לא בוחר הצעה, לא תבוצע קריאה לפרטי מקומות.
לאחר שהמשתמש בחר מקום (כלומר, בוצעה שיחה של 'פרטי מקומות'), עליכם להתחיל סשן חדש באמצעות אסימון סשן חדש.
ניתן ליצור פעילויות של השלמה אוטומטית מממשקי ה-API הבאים:
- שירות ההשלמה האוטומטית של מקומות ב-API או שירות ההשלמה האוטומטית של מקומות ב-API של JavaScript. עליך לעצב את האפליקציה כך שהיא תספק אסימוני סשנים (ייתכן שיהיה צורך לשנות את הקוד הקיים).
- הווידג'ט של ההשלמה האוטומטית ב-API של מפות Google ל-JavaScript. החיוב על בסיס סשנים מופעל באופן אוטומטי בווידג'טים האלה, ללא צורך בשינוי קוד.
אסימון סשן טוב בסשן אחד של משתמש, ואי אפשר להשתמש בו יותר מסשן אחד של משתמש. אם אתם עושים שימוש חוזר באסימון של סשן, הסשן נחשב לא חוקי והבקשות מחויבות כאילו לא סופק אסימון סשן.
הבקשות להשלמה אוטומטית ובקשות לפרטי מקומות באמצעות סשנים מחויבות במק"טים שונים.
מידע על מק"טים של נתוני מקומות
שלושת המק"טים של נתוני מקומות הם: נתונים בסיסיים, נתונים של אנשי קשר ונתוני אווירה.מק"ט אחד או יותר של נתונים מופעל עבור:
- Android: כל בקשה שנשלחה אל
fetchPlace()
או אלfindCurrentPlace()
- iOS: כל שיחה אל
fetchPlaceFromPlaceID:
או אלfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- שירות אינטרנט: כל בקשה מ'מקומות' בהתאם לשדות שצוינו בבקשה
מק"טים של נתונים תמיד מחויבים בנוסף למק"ט הבסיסי עבור הבקשה שמפעילה אותם. לדוגמה, בקשת 'פרטי מקום' שכוללת שדות של נתונים בסיסיים תחויב גם במק"ט של 'מידע בסיסי' וגם במק"ט של 'פרטי מקום'.
עבור שירות האינטרנט, ממשקי ה-API האלה של מקומות Google תומכים בציון שדות הנתונים שיש להחזיר:
לשירות האינטרנט, ממשקי ה-API האלה של מקומות Google מתקשרים אין תמיכה בציון השדות המוחזרים. קריאות אלה יחזירו תמיד את כל הנתונים של 'מקומות', ויגרמו לחיוב של שלושת המק"טים של נתוני 'מקומות' בנוסף לחיוב עבור כל בקשת API:
מק"ט: נתונים בסיסיים
באמצעות הפרמטר 'שדות' בבקשה או בפרטי המקום, אפשר להגביל את התגובה רק לשדות שצוינו. השדות בקטגוריה בסיסי כלולים בעלות הבסיסית של בקשת המקומות, והם לא מחייבים בתשלום נוסף. המק"ט של Data Basic מופעל כאשר מבקשים לפחות אחד מהשדות הבאים:
-
Android:
Place.Field.ADDRESS
,Place.Field.ADDRESS_COMPONENTS
,Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.ID
,Place.Field.LAT_LNG
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
,Place.Field.UTC_OFFSET
אוPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinesssStatus
,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
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
עלות בקשת המקומות + 0.00 USD |
עלות בקשת המקומות + 0.00 USD |
עלות בקשת המקומות + 0.00 USD |
מק"ט: נתוני אנשי קשר
באמצעות הפרמטר 'שדות' ב'פרטי מקום' או בבקשת 'חיפוש מקום' עבור שירותי אינטרנט, או מערך של Place.Field
עבור Android או iOS, ניתן להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה איש קשר מחייבים בתשלום נוסף. המק"ט של נתוני איש הקשר מופעל בכל פעם שמתקיים שדה חובה:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,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
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
עלות בקשת המקומות + 0.003 USD לכל אחד (+ 3.00 USD לכל 1000) |
עלות בקשת המקומות + 0.0024 USD לכל אחד (+ 2.40 USD לכל 1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
מק"ט: נתוני אווירה
באמצעות הפרמטר 'שדות' בבקשה לפרטי מקום או בבקשה למצוא מקום, תוכלו להגביל את התגובה רק לשדות שצוינו. שדות בקטגוריה אווירה מחייבים בתשלום נוסף. המק"ט של נתוני האווירה מופעל אם מתבצעת אחת מהשדות הבאות:
- במכשירי Android:
Place.Field.CURBSIDE_PICKUP
,Place.Field.DELIVERY
,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_RATINGS_TOTAL
- 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 USD לכל אחד (+ 5.00 USD לכל 1000) |
עלות בקשת המקומות + 0.004 USD לכל אחד (+ 4.00 USD לכל 1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
מק"ט: השלמה אוטומטית – לפי בקשה
המק"ט השלמה אוטומטית – לפי בקשה מחויב עבור כל אחת מהשיחות או הבקשות האלה שלא כוללות אסימון הפעלה:
- ב-Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: שירות ההשלמה האוטומטית ל-API של מפות Google עבור JavaScript
- שירות אינטרנט: שירות השלמה אוטומטית של מקומות ב-API
שיחות שמקורן בסשן לא חוקי של השלמה אוטומטית (לדוגמה, סשן שנעשה בו שימוש חוזר באסימון) הן גם תשלום של השלמה אוטומטית לפי בקשה.
בקשות להשלמה אוטומטית מווידג'ט ההשלמה האוטומטית ל-API של מפות Google עשויות להיות מחויבות עבור השלמה אוטומטית לכל בקשה – אם קריאות יבוצעו מסשן לא חוקי של השלמה אוטומטית. זה יכול לקרות אם משתמש מקליד כמה כתובות שונות או מעתיק/מדביק כתובות שונות בווידג'ט, ולא תמיד בוחר חיזוי להשלמה אוטומטית.
טווח חודשי חודשי (מחיר לבקשה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1000) |
0.00227 USD לכל (2.27 USD ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
מק"ט: השלמה אוטומטית ללא פרטי מקום – לכל ביקור
המק"ט של השלמה אוטומטית ללא פרטי מקום – לכל סשן מחויב עבור סשן של השלמה אוטומטית שלא כולל בקשה לפרטי מקום (תוך כמה דקות מתחילת הסשן).
טווח חודשי חודשי (מחיר לצפייה) |
||
---|---|---|
0.017 דולר ארה"ב לכל (17.00 דולר ארה"ב ל-1000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
דוגמה
אם האפליקציה מבצעת את שתי הקריאות האלה בסשן אחד:
Android
- findהשלמה החזויה() (.setQuery(”par”), .setSessionToken(XYZ))
- findהשלמה החזויה() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findcompleteחיזוי(מ-Query: "par" ...
- placesClient?.findcompleteחיזוי(מ-Query: "paris" ...
שירות אינטרנט
- בקשה להשלמה אוטומטית של מקום (input=”par”, סשן_טוקן: XYZ)
- בקשה להשלמה אוטומטית של מיקום (input=”paris”, סשן_טוקן: XYZ)
בחשבון שלך יופיע המק"ט הזה (בעת הצגת החיוב לפי מק"ט):
- השלמה אוטומטית ללא פרטי מקום – לכל פעילות באתר (מחיר החל מ-0.017 דולר ארה"ב לפעילות)
מק"ט: השלמה אוטומטית (כלולה בפרטי המקום) – לכל פעילות באתר
מק"ט ההשלמה האוטומטית (הכלולה עם פרטי המקום) – לכל סשן – מחויב עבור סשן של השלמה אוטומטית שכולל אחד מהערכים הבאים:
- Android: שיחה אל
fetchPlace()
- iOS: שיחה אל
fetchPlaceFromPlaceID:
- שירות אינטרנט: בקשה לפרטי מקום
הבקשה להשלמה אוטומטית זמינה ללא חיוב, והשיחה שלאחר מכן בפרטי המקום מבוססת על תמחור רגיל של פרטי מקום.
בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, איש קשר ו/או אווירה) – בהתאם לשדות שצוינו בבקשה.
אם לא מציינים שדות בבקשה של 'פרטי מקום', כל המק"טים של הנתונים מופעלים ('בסיסי', 'איש קשר' ו'אטמוספירה').
בקשות רענון של מזהה פרטי מקום (בקשות המציינות רק את השדה place_id
) במהלך פעילות של השלמה אוטומטית מחויבות כ-SKU: השלמה אוטומטית ללא פרטי מקום – לכל פעילות באתר.
טווח חודשי חודשי (מחיר לצפייה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
אם האפליקציה מבצעת את שלוש הקריאות הבאות בסשן יחיד:
Android
- findהשלמה החזויה() (.setQuery(”par”), .setSessionToken(XYZ))
- findהשלמה החזויה() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (עם
FetchPlaceRequest
כולל מזהה המקום, והשדה ADDRESS)
iOS
- placesClient?.findcompleteחיזוי(מ-Query: "par" ...
- placesClient?.findcompleteחיזוי(מ-Query: "paris" ...
- fetchPlaceFromPlaceID:(כולל מזהה המקום והשדה
GMSPlaceFieldFormattedAddress
)
שירות אינטרנט
- מקומות להשלמה אוטומטית של מקומות (input=”par”, סשן_טוקן: XYZ)
- מקומות להשלמה אוטומטית של מקומות (input=”paris”, חיבור_סשן: XYZ)
- פרטי מקומות (place_id, session_token: XYZ, שדות:format_address)
בחשבון יופיעו המק"טים האלה (בעת הצגת החיוב לפי מק"ט):
- השלמה אוטומטית (הכלולה עם פרטי המקום) – לכל פעילות באתר (חיוב במחיר של 0.00 דולר ארה"ב)
- פרטי מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לביקור)
- נתונים בסיסיים (חיוב של 0.00 USD)
מק"ט: השלמה אוטומטית של שאילתות – לכל בקשה
מק"ט של השלמה אוטומטית של שאילתה – לכל בקשה מחויב עבור כל בקשה כדי:
- JavaScript:
שירות ההשלמה האוטומטית של מקומות של JavaScript ל-API (
getQueryPredictions()
) והשימוש ב ווידג'ט של SearchBox ל-API של מפות Google (בקשות להשלמה אוטומטית של שאילתות נוצרות בתור סוגי המשתמשים). - שירות אינטרנט: שירות ההשלמה האוטומטית של שאילתות API
טווח חודשי חודשי (מחיר לבקשה) |
||
---|---|---|
0.00283 USD לכל (2.83 USD ל-1000) |
0.00227 USD לכל (2.27 USD ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
אין תמיכה בתמחור לפי השלמה אוטומטית באמצעות השלמה אוטומטית של שאילתות. בהמשך, החיוב על שיחות בפרטי המקומות מבוסס על התמחור הרגיל של פרטי מקומות.
מק"ט: פרטי המקום
שיחות של פרטי מקום יחויבו באופן הבא:
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 דולר ארה"ב לכל (17.00 דולר ארה"ב ל-1000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
המק"ט פרטי מקום נוצר מתוך ממשקי ה-API האלה:
- Android: SDK SDK ל-Android
(
fetchPlace()
) - iOS: SDK SDK ל-iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
שירות Place API של מפות Google JavaScript (
getDetails
) - JavaScript:
הווידג'ט של ההשלמה האוטומטית של JavaScript ב-Maps API (
getPlace
) - JavaScript:
הווידג'ט של תיבת ה-API של JavaScript ב-Maps API:
getPlaces()
אחרי שהמשתמש בוחר תוצאת מקום (סמל: סיכה), *לא* בשאילתה (סמל: זכוכית מגדלת), כפי שמתואר כאן:בתוצאות של הווידג'ט של תיבת החיפוש, לאחר הקלדת "פיצה" בתיבת החיפוש יש סמל סיכה ליד הסמל הזה. - שירות אינטרנט: שירות Places API של פרטי מקום
באמצעות ה-API והשירותים באינטרנט, המק"ט של פרטי המקום מחויב גם אם אסימון הסשן הוגדר וגם אם לא.
שיחה או בקשה של פרטי מקום יוצרים גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אווירה), בהתאם לשדות שצוינו בשיחה או בבקשה. אם שדות No צוינו בשיחה או בבקשה של פרטי המקום, כל המק"טים של הנתונים הופעלו, ואתם תחויבו על השיחה או על הבקשה של פרטי מקומות ועלות כל הנתונים.
דוגמאות
- מבצעים אחת מהשיחות או הבקשות הבאות:
- נייד: התקשרות למספר
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS, וציינו רק את השדהADDRESS
- בשירות או ב-Web API: שולחים בקשה של פרטי מקום ומציינים רק את שדה הכתובת:
getPlaceDetails(fields: formatted_address)
- פרטי מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לביקור)
- נתונים בסיסיים (חיוב של 0.00 USD)
- נייד: התקשרות למספר
- מבצעים אחת מהשיחות או הבקשות הבאות:
- נייד: התקשרות למספר
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS, וציינו רק את השדהPHONE_NUMBER
- Web API או שירות באינטרנט: שולחים בקשה לפרטי המקום ומציינים את שדה מספר הטלפון:
getPlaceDetails(fields: formatted_phone_number)
- פרטי מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לביקור)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נייד: התקשרות למספר
- מבצעים אחת מהשיחות או הבקשות הבאות:
- נייד: התקשרות ל-
fetchPlace()
ב-Android אוfetchPlaceFromPlaceID:
ב-iOS, וציינו את כל השדות - Web API או שירות: שולחים בקשת פרטי מקום ומציינים את כל השדות (בקשה מסוג זה היא ברירת המחדל אם לא מציינים שדות):
getPlaceDetails()
.
- פרטי מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לביקור)
- נתונים בסיסיים (חיוב של 0.00 USD)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
- נייד: התקשרות ל-
מק"ט: פרטי מקום – רענון מזהה
יש להשתמש בבקשת פרטי מקום כדי לרענן מזהי מקום לא עדכניים. בקשות מהסוגים האלה זמינות ללא תשלום.
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
שולחים בקשת פרטי מקום ומציינים רק את שדה מזהה המקום:
getPlaceDetails(fields: place_id)
.
בחשבון שלך יופיע המק"ט הזה (בעת הצגת החיוב לפי מק"ט):
- פרטי מקום – רענון מזהה (חיוב בסך 0.00 ILS)
מק"ט: חיפוש מקום
הפריט חיפוש מקום מחויב על בקשה לאיתור מקום.
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.017 דולר ארה"ב לכל (17.00 דולר ארה"ב ל-1000) |
0.0136 דולר ארה"ב לכל (13.60 דולר ארה"ב ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
בקשות 'מקום' יוצרות גם מק"טים של נתונים (בסיסי, יצירת קשר ו/או אווירה), בהתאם לשדות שצוינו בבקשה. כמו בקשות של פרטי מקום, ניתן להשתמש בפרמטר 'שדות' בבקשת 'חיפוש מקום' כדי להגביל את התגובה רק לשדות שצוינו. החיוב הוא על בקשת 'חיפוש מקום' ועל הנתונים שביקשתם. כברירת מחדל, אם הבקשה היא לא לשדות, מוחזר רק מזהה המקום, כך שלא נדרשים חיובים נוספים על נתונים.
דוגמאות
- כששולחים בקשת 'חיפוש מקום' ומציינים רק את שדה הכתובת:
FindPlace(fields: formatted_address)
. בחשבון יופיעו המק"טים האלה (כאשר מוצג החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
- נתונים בסיסיים (חיוב של 0.00 USD)
- כותבים בקשת 'חיפוש מקום' ומציינים את שדה מספר הטלפון:
FindPlace(fields: formatted_phone_number)
. בחשבון יופיעו המק"טים הבאים (בעת הצגת החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- כותבים בקשת 'חיפוש מקום' ומציינים שדות בכל שלוש הקטגוריות של סוגי הנתונים:
FindPlace(fields: formatted_address, opening_hours, price_level)
. בחשבון יופיעו המק"טים האלה (כאשר מוצג החשבון לפי מק"ט):- חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
- נתונים בסיסיים (חיוב של 0.00 USD)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
מק"ט: חיפוש מקום – מזהה בלבד
השדה חיפוש מקום – מזהה בלבד מחויב על בקשות לאיתור מקום, שמציינות רק את מזהה המקום להחזרה. כברירת מחדל, אם לא מצוינים שדות בבקשת 'חיפוש מקום', מוחזר רק מזהה המקום.
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
דוגמה
כששולחים בקשת חיפוש מקום, מציינים רק את השדה place_id
: 'FindPlace(fields: place_id)
'.
בחשבון שלך יופיע המק"ט הזה (בעת הצגת החיוב לפי מק"ט):
- חיפוש מקום – מזהה בלבד (חיוב ב-0.00 דולר ארה"ב)
מק"ט: מקום – חיפוש בקרבת מקום
מקום – חיפוש בקרבת מקום מחויב עבור בקשות
לשירות 'חיפוש בקרבת מקום' של ה-API של מפות Google
(nearbySearch()
), או
ל
שירות 'חיפוש בקרבת מקום' של API
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב ל-1000) |
0.0256 USD לכל (25.60 USD ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
בקשות לחיפוש בקרבת מקום מחזירה רשימה של מקומות, אך אינן תומכות בציון השדות שמוחזרים. בקשות 'חיפוש בקרבת מקום' מחזירות קבוצת משנה של שדות הנתונים הנתמכים. נחייב אותך על הבקשה לחיפוש בקרבת מקום החל מ-0.032 דולר ארה"ב לאחד, ועל כל המק"טים של סוגי הנתונים (נתונים בסיסיים, נתונים ליצירת קשר ונתוני אווירה).
דוגמה
שולחים בקשה לחיפוש בקרבת מקום, למשל NearbySearch (San Francisco, 100 meters)
.
בחשבון יופיעו המק"טים האלה (בעת הצגת החיוב לפי מק"ט):
- מקום – חיפוש בקרבת מקום (המחיר מתחיל מ-0.032 דולר ארה"ב לשיחה)
- נתונים בסיסיים (חיוב של 0.00 USD)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
מק"ט: מקום – חיפוש טקסט
מקום – חיפוש טקסט מחויב על בקשות
של שירות 'טקסט לחיפוש' של JavaScript ב-Maps API (textSearch()
), או על
שירות חיפוש הטקסט של מקומות API.
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.032 דולר ארה"ב לכל (32.00 דולר ארה"ב ל-1000) |
0.0256 USD לכל (25.60 USD ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
בקשות לחיפוש טקסט יחזירו רשימה של מקומות, אבל הן לא תומכות בציון השדות שמוחזרים. בקשות לחיפוש טקסט יחזירו קבוצת משנה של שדות הנתונים הנתמכים. נחייב אותך על הבקשה לחיפוש טקסט החל מ-0.032 דולר ארה"ב לאחד, ועל כל המק"טים של סוגי הנתונים (נתונים בסיסיים, נתונים ליצירת קשר ונתוני אווירה).
המק"ט 'חיפוש מקום' – טקסט נוצר גם על ידי
הווידג'ט של תיבת החיפוש של JavaScript ב-Maps API: getPlaces()
לאחר שהמשתמש בוחר שאילתת מקום (סמל: זכוכית מגדלת), לא
תוצאה (סמל: סיכה), כפי שמתואר כאן:

דוגמה
שולחים בקשה לחיפוש טקסט, למשל TextSearch(123 Main Street)
. בחשבון יופיעו המק"טים האלה (בעת הצגת החשבון לפי מק"ט):
- מקום - חיפוש טקסט (המחיר מתחיל מ-0.032 דולר ארה"ב לשיחה)
- נתונים בסיסיים (חיוב של 0.00 USD)
- נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
- נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)
מק"ט: תמונה של המקום
מק"ט של תמונה של מקום מחויב בסכום הזה:
- Android: שיחות אל
fetchPhoto()
- iOS: שיחות אל
loadPlacePhoto:
- JavaScript: עד לספריית 'מקומות', לשירות 'תמונות Google' ב-API של 'מפות' בעת בקשת נתונים מכתובות האתרים שהוחזרו על ידי
PlacePhoto.getUrl()
טעינת נתוני פיקסל של תמונה - שירות אינטרנט: בקשות ל-Photos API Place Service Photos
בשירות ה-JavaScript, הפעלת השיטה PlacePhoto.getUrl()
לא גורמת לחיוב עד שכתובת ה-URL משמשת בפועל לקבלת נתוני פיקסל.
טווח חודשי חודשי (מחיר לשיחה) |
||
---|---|---|
0.007 דולר ארה"ב לכל (7.00 USD לכל 1000) |
0.0056$ לכל (5.60$ ל-1000) |
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון |
מגבלות שימוש אחרות
למרות שאין מספר מקסימלי של בקשות ליום, מגבלת השימוש הבאה עדיין חלה על השימוש במקומות Google API:
- מגבלת הקצב היא 100 בקשות לשנייה. הוא מחושב בתור הסכום של בקשות בצד הלקוח ובצד השרת עבור כל היישומים באמצעות פרטי הכניסה של אותו פרויקט.
הגבלות על התנאים וההגבלות
למידע על התנאים וההגבלות, תוכלו לקרוא את המדיניות לגבי Places API ואת הגבלות הרישיון בתנאים ובהגבלות של הפלטפורמה של מפות Google.
ניהול עלות השימוש
כדי לנהל את עלות השימוש ב-API של הפלטפורמה של מפות Google, צריך להגדיר מגבלות מכסה יומיות על כל הבקשות ל-API לחיוב. המכסות היומיות מתאפסות בחצות לפי שעון האוקיינוס השקט.
כדי לראות או לשנות את מגבלות המכסה עבור ה-API של מקומות Google:
- ב-Cloud Console, פותחים את המכסות של הפלטפורמה של מפות Google.
- לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים ב-Places API.
- כדי לראות את המגבלות במכסות, גוללים למטה לכרטיס Requests.
טבלה מפרטת את השמות והמגבלות של המכסות. - כדי לשנות את המכסה, לוחצים על סמל העריכה של המכסה.
בתיבת הדו-שיח שמוצגת, בשדה Quota Limit מזינים את המגבלה היומית המועדפת למכסה (עד למכסה שהוגדרה, אם יש כזו) ובוחרים באפשרות Save.
אם השימוש ב-API יגיע למגבלת המכסה לחיוב ביום נתון, האפליקציה לא תוכל לגשת ל-API עד סוף היום.
משאבים קשורים לניהול עלויות
-
משתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני יצירת חשבון לחיוב ב-Google Maps Platform, כדי לקבל קרדיט ל-Maps Platform.↩