שימוש וחיובים ב-'מקומות Google'

ה-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 הבאים:

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

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

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

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

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

  • 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–100,000 100,001–500,000 מעל 500,000
עלות בקשת המקומות
+ 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–100,000 100,001–500,000 מעל 500,000
עלות בקשת המקומות
+ 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–100,000 100,001–500,000 מעל 500,000
עלות בקשת המקומות
+ 0.005 USD לכל אחד
(+ 5.00 USD לכל 1000)
עלות בקשת המקומות
+ 0.004 USD לכל אחד
(+ 4.00 USD לכל 1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

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

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

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

טווח חודשי חודשי
(מחיר לבקשה)
0–100,000 100,001–500,000 מעל 500,000
0.00283 USD לכל
(2.83 USD ל-1000)
0.00227 USD לכל
(2.27 USD ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

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

טווח חודשי חודשי
(מחיר לצפייה)
0–100,000 100,001–500,000 מעל 500,000
0.017 דולר ארה"ב לכל
(17.00 דולר ארה"ב ל-1000)
0.0136 דולר ארה"ב לכל
(13.60 דולר ארה"ב ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

דוגמה

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

Android

iOS

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

בחשבון שלך יופיע המק"ט הזה (בעת הצגת החיוב לפי מק"ט):

  • השלמה אוטומטית ללא פרטי מקום – לכל פעילות באתר (מחיר החל מ-0.017 דולר ארה"ב לפעילות)

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

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

  • Android: שיחה אל fetchPlace()
  • iOS: שיחה אל fetchPlaceFromPlaceID:
  • שירות אינטרנט: בקשה לפרטי מקום

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

בקשה של פרטי מקום יוצרת מק"טים של נתונים (בסיסי, איש קשר ו/או אווירה) – בהתאם לשדות שצוינו בבקשה.

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

בקשות רענון של מזהה פרטי מקום (בקשות המציינות רק את השדה place_id) במהלך פעילות של השלמה אוטומטית מחויבות כ-SKU: השלמה אוטומטית ללא פרטי מקום – לכל פעילות באתר.

טווח חודשי חודשי
(מחיר לצפייה)
0–100,000 100,001–500,000 מעל 500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

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

Android

iOS

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

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

  • השלמה אוטומטית (הכלולה עם פרטי המקום) – לכל פעילות באתר (חיוב במחיר של 0.00 דולר ארה"ב)
  • פרטי מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לביקור)
  • נתונים בסיסיים (חיוב של 0.00 USD)

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

מק"ט של השלמה אוטומטית של שאילתה – לכל בקשה מחויב עבור כל בקשה כדי:

טווח חודשי חודשי
(מחיר לבקשה)
0–100,000 100,001–500,000 מעל 500,000
0.00283 USD לכל
(2.83 USD ל-1000)
0.00227 USD לכל
(2.27 USD ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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


מק"ט: פרטי המקום

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

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.017 דולר ארה"ב לכל
(17.00 דולר ארה"ב ל-1000)
0.0136 דולר ארה"ב לכל
(13.60 דולר ארה"ב ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

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

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

דוגמאות

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

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

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

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

שולחים בקשת פרטי מקום ומציינים רק את שדה מזהה המקום: getPlaceDetails(fields: place_id). בחשבון שלך יופיע המק"ט הזה (בעת הצגת החיוב לפי מק"ט):

  • פרטי מקום – רענון מזהה (חיוב בסך 0.00 ILS)

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

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

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.017 דולר ארה"ב לכל
(17.00 דולר ארה"ב ל-1000)
0.0136 דולר ארה"ב לכל
(13.60 דולר ארה"ב ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

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

דוגמאות

  1. כששולחים בקשת 'חיפוש מקום' ומציינים רק את שדה הכתובת: FindPlace(fields: formatted_address). בחשבון יופיעו המק"טים האלה (כאשר מוצג החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
    • נתונים בסיסיים (חיוב של 0.00 USD)
  2. כותבים בקשת 'חיפוש מקום' ומציינים את שדה מספר הטלפון: FindPlace(fields: formatted_phone_number). בחשבון יופיעו המק"טים הבאים (בעת הצגת החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
    • נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
  3. כותבים בקשת 'חיפוש מקום' ומציינים שדות בכל שלוש הקטגוריות של סוגי הנתונים: FindPlace(fields: formatted_address, opening_hours, price_level). בחשבון יופיעו המק"טים האלה (כאשר מוצג החשבון לפי מק"ט):
    • חיפוש מקום (המחיר מתחיל מ-0.017 דולר ארה"ב לשיחה)
    • נתונים בסיסיים (חיוב של 0.00 USD)
    • נתונים של אנשי קשר (מחיר החל מ-0.003 דולר ארה"ב לבקשה)
    • נתוני אווירה (מחיר החל מ-0.005 דולר ארה"ב לבקשה)

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

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

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.00 USD 0.00 USD 0.00 USD

דוגמה

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

  • חיפוש מקום – מזהה בלבד (חיוב ב-0.00 דולר ארה"ב)

מקום – חיפוש בקרבת מקום מחויב עבור בקשות לשירות 'חיפוש בקרבת מקום' של ה-API של מפות Google (nearbySearch()), או ל שירות 'חיפוש בקרבת מקום' של API

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
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–100,000 100,001–500,000 מעל 500,000
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 דולר ארה"ב לבקשה)

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

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

בשירות ה-JavaScript, הפעלת השיטה PlacePhoto.getUrl() לא גורמת לחיוב עד שכתובת ה-URL משמשת בפועל לקבלת נתוני פיקסל.

טווח חודשי חודשי
(מחיר לשיחה)
0–100,000 100,001–500,000 מעל 500,000
0.007 דולר ארה"ב לכל
(7.00 USD לכל 1000)
0.0056$ לכל
(5.60$ ל-1000)
ליצירת קשר עם מחלקת המכירות כדי לברר לגבי נפח אחסון

מגבלות שימוש אחרות

למרות שאין מספר מקסימלי של בקשות ליום, מגבלת השימוש הבאה עדיין חלה על השימוש במקומות Google API:

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

הגבלות על התנאים וההגבלות

למידע על התנאים וההגבלות, תוכלו לקרוא את המדיניות לגבי Places API ואת הגבלות הרישיון בתנאים ובהגבלות של הפלטפורמה של מפות Google.

ניהול עלות השימוש

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

כדי לראות או לשנות את מגבלות המכסה עבור ה-API של מקומות Google:

  1. ב-Cloud Console, פותחים את המכסות של הפלטפורמה של מפות Google.
  2. לוחצים על התפריט הנפתח של ממשקי ה-API ובוחרים ב-Places API.
  3. כדי לראות את המגבלות במכסות, גוללים למטה לכרטיס Requests.
    טבלה מפרטת את השמות והמגבלות של המכסות.
  4. כדי לשנות את המכסה, לוחצים על סמל העריכה של המכסה.
    בתיבת הדו-שיח שמוצגת, בשדה Quota Limit מזינים את המגבלה היומית המועדפת למכסה (עד למכסה שהוגדרה, אם יש כזו) ובוחרים באפשרות Save.

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


  1. משתמשים בהודו צריכים ליצור חשבון לחיוב ב-Google Cloud Platform לפני יצירת חשבון לחיוב ב-Google Maps Platform, כדי לקבל קרדיט ל-Maps Platform.