מקומות שימוש וחיוב ב-API

חיוב ותמחור של Places API

למידע על האופן שבו Google מחשבת את החיוב והתמחור, אפשר לעיין במחירון של הפלטפורמה של מפות Google או במחירון של הפלטפורמה של מפות Google – הודו.

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

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

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

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

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

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

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

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

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

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

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

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

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

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

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

המק"ט הזה מחויב על כל בקשה ל-API של השלמה אוטומטית (חדש) שכוללת אסימון סשן.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

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

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

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

למידע נוסף, ראו השלמה אוטומטית (חדש) ותמחור סשנים.

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Places API Place Details Essentials (IDs Only)

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

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

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

  • שירות אינטרנט:
    attributions
    id
    name*
    photos

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

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

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

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

מק"ט: Places API Place Details Essentials

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

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

  • שירות אינטרנט:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

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

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

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

מק"ט: Places API Place Details Pro

המק"ט הזה מחויב על שדות שציינתם בבקשה ל-Place Details Pro.

  קטגוריה Pro
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר:
  • שירות אינטרנט:
    accessibilityOptions
    businessStatus
    containingPlaces
    displayName
    googleMapsLinks*
    googleMapsUri
    iconBackgroundColor
    iconMaskBaseUri
    primaryType
    primaryTypeDisplayName
    pureServiceAreaBusiness
    subDestinations
    utcOffsetMinutes

    * השדה googleMapsLinks נמצא בשלב תצוגה מקדימה לפני GA, ללא חיוב, כלומר החיוב הוא 0 $על שימוש במהלך תקופת התצוגה המקדימה.

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

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

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

מק"ט: Places API Place Details Enterprise

המק"ט הזה מחויב על בקשה של Places שכוללת שדות של Enterprise.

  קטגוריה Enterprise
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט הזה מופעל כשמבקשים את השדות הבאים:
  • שירות אינטרנט: currentOpeningHours
    currentSecondaryOpeningHours
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    priceRange
    rating
    regularOpeningHours
    regularSecondaryOpeningHours
    userRatingCount
    websiteUri

אם תסיימו סשן של השלמה אוטומטית באמצעות קריאה ל-Place Details שמבקשת כל שדה מ-SKU: Place Details (Basic, Advanced, or Preferred), הקריאה תחויב לפי SKU: Place Details (Preferred). למידע נוסף, ראו מק"ט: שימוש בסשן של השלמה אוטומטית.

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

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

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

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

המק"ט הזה מחויב על קריאות ל-Place Details API שבהן מבקשים את שדות האווירה שצוינו.

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים

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

  • שירות אינטרנט:
    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

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

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

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

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

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

מק"ט: Places API Nearby Search Pro

המק"ט הזה מחויב על שדות שציינתם בבקשה ל-חיפוש בקרבת מקום Pro.

  קטגוריה Pro
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם שיעור נמוך יותר:
  • שירות אינטרנט:
    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 נמצא בשלב טרום-השקה (Preview) ואין חיוב, כלומר החיוב הוא 0 $על שימוש במהלך גרסת ה-Preview.

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

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

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

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

מק"ט: Places API Nearby Search Enterprise

המק"ט הזה מחויב על בקשות לחיפוש עסקים בקרבת מקום שכוללות שדות של Enterprise.

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

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

  • שירות אינטרנט:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

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

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

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

מק"ט: Places API Nearby Search Enterprise + Atmosphere

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

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים

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

  • שירות אינטרנט:
    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

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

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

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

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

מק"ט: Places API Text Search Essentials (IDs Only)

המק"ט הזה מחויב על בקשות ל-Text Search API שמחזירות רק מזהי מסמכים.
  קטגוריה Essentials
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים

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

  • שירות אינטרנט:
    places.attributions
    places.id
    places.name*
    nextPageToken

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

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

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

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

מק"ט: Places API Text Search Pro

המק"ט הזה הוא מק"ט נתונים שמשמש לחיוב על שדות שציינתם בבקשה ל-Text Search Pro.
  קטגוריה Pro
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט הזה מופעל כשמבקשים רק את השדות הבאים או שדות עם תמחור נמוך יותר:
  • שירות אינטרנט:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.location
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * השדה places.googleMapsLinks נמצא בשלב טרום-השקה (Preview) ואין חיוב, כלומר החיוב הוא 0 $על שימוש במהלך תקופת ה-Preview.

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

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

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

מק"ט: Places API Text Search Enterprise

המק"ט הזה מחויב על בקשות לחיפוש טקסט שכוללות שדות Enterprise.

  קטגוריה Enterprise
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט הזה מופעל כשמבקשים את השדות הבאים:
  • שירות אינטרנט:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

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

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

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

מק"ט: Places API Text Search Enterprise + Atmosphere

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

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כשמבקשים את השדות הבאים:
  • שירות אינטרנט:
    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

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

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

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

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

מק"ט: Place Details Photos

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

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל כששולחים בקשה לתמונה מ-Place Details API.
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שדות בקטגוריה בסיסי כלולים במחיר הבסיס של הבקשה ל-Places ולא גוררים חיוב נוסף.

  קטגוריה Essentials
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט 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
  דוגמאות לחיוב באמצעות מסכת שדות

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

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

מק"ט: פרטי איש קשר

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

אפשר להגביל את התשובה רק לשדות שצוינו באמצעות הפרמטר fields בבקשה לפרטים של מקום או ל'חיפוש מקום' בשירותי אינטרנט, או באמצעות מערך של Place.Field ב-Android או ב-iOS. שדות בקטגוריה איש קשר יגרמו לחיוב נוסף.

  קטגוריה Enterprise
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים המק"ט Contact Data מופעל כשמתבצע ניסיון לשלוח בקשה לאחד מהשדות הבאים:
  • 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
  דוגמאות לחיוב באמצעות מסכת שדות

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

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

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

המק"ט הזה מחויב על בקשות ל-Atmosphere Data API שמציינות את השדות שבמק"ט הזה.

  קטגוריה Enterprise
  אירוע לחיוב בקשה עם מסכות השדות שצוינו.
  טריגרים החיוב מופעל כשמבקשים את אחד מהשדות הבאים:
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.
  דוגמאות לחיוב באמצעות מסכת שדות

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

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

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

המק"ט הזה מחויב על בקשות שלא כוללות אסימון סשן

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

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

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל עבור:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

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

  • השלמה אוטומטית ללא פרטי מקום – לכל סשן
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  קטגוריה Essentials
  אירוע לחיוב סשן
  טריגרים ה-SKU השלמה אוטומטית (כלולה בפרטים של מקומות) – לכל סשן מחויב על סשן השלמה אוטומטית שכולל אחת מהבקשות הבאות:
  • Android: קריאה ל-fetchPlace()
  • iOS: קריאה ל-fetchPlaceFromPlaceID:
  • שירות אינטרנט: בקשה לקבלת פרטי מקום

בקשה לפרטים על מקום יוצרת מק"טים של נתונים (Basic,‏ Contact ו/או Atmosphere) בהתאם לשדות שציינתם בבקשה.

אם לא מבקשים שדות ספציפיים בבקשה לפרטים על המקום, כל המק"טים של נתונים מופעלים (Essentials,‏ Pro,‏ Enterprise ו-Enterprise + Atmosphere). כדי להימנע מחיובים מיותרים, עליכם לציין רק את השדות הנחוצים לכם.

אם מבקשים רק לרענן את מזהה פרטי המקום (הבקשה כוללת רק את השדה place_id) במהלך סשן השלמה אוטומטית, הסשן יחויב כ-SKU: Autocomplete without Place Details – Per Session.

  דוגמאות

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

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

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

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

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

המק"ט הקודם הזה מחויב על בקשות להשלמה אוטומטית של שאילתות.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים

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

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

  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

מק"ט: Place Details Pro

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל על בקשות מממשקי ה-API הבאים:

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

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

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

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

המק"ט הזה מחויב על בקשות ל-Place Details API שמטרתן לעדכן מזהי מקומות לא עדכניים.

  קטגוריה Essentials
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל כששולחים בקשה לפרטים של מקום ומציינים רק את השדה place id:‏getPlaceDetails(fields: place_id).
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מחויב על בקשות לשיטות הבאות:
  • חיפוש המקום הנוכחי

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

  דוגמאות

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

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

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

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

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

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

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

  קטגוריה Pro
  אירוע לחיוב בקשה
  טריגרים המק"ט הזה מופעל כששולחים בקשה לחיפוש בקרבת מקום באמצעות אחד מה-API הבאים:

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

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

  דוגמאות

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

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

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

המק"ט הזה מחויב על בקשות לשירות Places Text Search.

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

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

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

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

אם שולחים בקשה לחיפוש טקסט, כמו TextSearch(123 Main Street), המק"טים הבאים יופיעו בחשבונית כשמציגים את החשבונית לפי מק"ט:

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

מק"ט: Places API Place Details Photos

המק"ט הזה מחויב על שירות התמונות הקודם של מפות Google.

  קטגוריה Enterprise
  אירוע לחיוב בקשה
  טריגרים החיוב מופעל עבור:
  Pricing טבלת התמחור הראשית
טבלת התמחור בהודו

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

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

  • Places API (חדש): מגבלת הקצב היא 600 בקשות לשעה לכל שיטת API לכל פרויקט. כלומר, לכל method של API יש מכסה נפרדת.

  • Places API: מגבלת הקצב היא 6,000 בקשות לדקה. הוא מחושב כסכום של הבקשות בצד הלקוח ובצד השרת לכל האפליקציות שמשתמשות בפרטי הכניסה של אותו פרויקט.

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

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