Maps JavaScript API 採用「即付即用」定價模式。 Maps JavaScript API 要求會根據要求類型產生兩種 SKU 呼叫:地圖載入或全景。呼叫 Maps JavaScript API Places Library 和 其他 JavaScript 服務的價格不同 從 JavaScript 原生 SKU 擷取出來 除了整體的 Google 使用條款,仍須遵守用量限制 Maps JavaScript API 專屬的物件。 請使用 Google Cloud 控制台提供的工具管理費用和用量。
Maps JavaScript API 計費方式
Maps JavaScript API 採用「即付即用」定價模式。Google 地圖平台 API 和 SDK 是按 SKU 計費。系統會追蹤每個 SKU 的用量,單一 API 或 SDK 可能會有多個產品 SKU。費用計算方式如下:
您可以使用定價和用量計算工具估算每個 API 或 SDK 的使用費。針對符合條件的 Google 地圖平台 SKU,每個帳單帳戶每個月都能獲得 $200 美元的 Google 地圖平台抵免額,這筆抵免額會自動存入帳戶 僅適用於符合條件的 SKU
Maps JavaScript API 定價
SKU:Dynamic Maps
如果這個應用程式使用 Maps JavaScript API,則顯示的地圖可載入或不載入地圖 ID;如果使用 Maps SDK for Android 或 Maps SDK for iOS,則顯示的地圖會一併載入地圖 ID。
每月用量範圍 (每次載入地圖的價格) |
||
---|---|---|
每次 $0.007 美元 (每 1,000 次 $7.00 美元) |
每次 $0.0056 美元 (每 1,000 次 $5.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
使用者與地圖之間的互動 (例如平移、縮放或切換地圖圖層) 不會產生額外的地圖載入量。
SKU:Dynamic Street View
街景服務全景和地圖載入量現已分開計費。每次針對 Maps JavaScript API、Maps SDK for Android、Maps SDK for iOS 應用程式中的全景物件建立例項,系統會視為動態街景服務全景來計費。
每月用量範圍 (每次全景的價格) |
||
---|---|---|
每次 $0.014 美元 (每 1,000 次 $14.00 美元) |
每次 $0.0112 美元 (每 1,000 次 $11.20 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
全景物件在下列情況中會例項化:
- 在 JavaScript 中使用
google.maps.StreetViewPanorama()
類別或Map.getStreetView()
方法。不論是使用街景服務衣夾人控制項內建的街景服務體驗,還是使用StreetViewService()
類別,我們都不會收取相關費用。 - 在 Android 中使用
StreetViewPanoramaFragment
、SupportStreetViewPanoramaFragment
或StreetViewPanoramaView
其中一個類別。每次呼叫相關的onCreate()
方法,就計為一次全景要求。 - 在 iOS 中使用
GMSPanoramaView
物件。
Maps JavaScript API Places Library 定價
SKU:Autocomplete Request
針對向 Autocomplete Request SKU, 不含工作階段符記的 Autocomplete (新版) API。
如果您使用工作階段符記,且符合下列任一情況,系統也會向您收費:
- 透過向 Place Details (新版) 的單一要求終止工作階段,且
要求 SKU:Place Details (Location Only) 定義的任何欄位。
- 每個 Autocomplete (新版) 請求 (最多 12 個) 要求,是按 SKU:Autocomplete Request。
- 後續的每項 Autocomplete (新) 要求,都是使用 SKU:Autocomplete Session Usage。
- 如要捨棄工作階段或結束工作階段,請呼叫 SKU:Place Details (僅限 ID)。之後所有 Autocomplete (新版) 要求都會計費 請使用 SKU:Autocomplete Request。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.00283 美元 (每 1,000 次 2.83 美元) |
每次 0.00227 美元 (每 1,000 次 2.27 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Autocomplete Session Usage
針對傳送至 Autocomplete 工作階段用量的 SKU, 包含工作階段符記的 Autocomplete (新版) API。
針對以下情況,系統會收取此 SKU 費用:
Autocomplete 工作階段因呼叫 SKU:Place Details (Location Only) 而終止:
- 每個 Autocomplete (新版) 請求 (最多 12 個) 要求,是按 SKU:Autocomplete Request。
- 後續的每項 Autocomplete (新) 要求,都是使用 SKU:Autocomplete Session Usage。
Autocomplete 工作階段結束,並呼叫 SKU:Place Details (基本、進階或首選)。
Place Details 呼叫,會從 SKU:Place Details (Basic、Advanced 或 Preferred): SKU:Place Details (Preferred)。
Autocomplete 工作階段結束並呼叫 SKU:Address Validation 建議提供。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每個 0.00 美元 (每 1,000 個 0.00 美元) |
每個 0.00 美元 (每 1,000 個 0.00 美元) |
每個 0.00 美元 (每 1,000 個 0.00 美元) |
SKU:Place Details (僅限 ID)
在 Place Details (新版) 要求中使用欄位遮罩或欄位清單,您可以設定 回應只回應指定的欄位。這個 SKU「只會」 要求下列欄位:
Maps JavaScript API Places Library:
id
,
photos
敬上
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每個 0.0 美元 (每 1,000 個 0.00 美元) |
每個 0.0 美元 (每 1,000 個 0.00 美元) |
每個 0.0 美元 (每 1,000 個 0.00 美元) |
SKU:Place Details (Location Only)
在 Place Details (新版) 要求中使用欄位遮罩或欄位清單,您可以設定 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
types
,
viewport
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每個 0.005 美元 (每 1,000 個 5.00 美元) |
每個 0.004 美元 (每 1,000 個 4.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Place Details (基本)
在 Place Details (新版) 要求中使用欄位遮罩或欄位清單,您可以設定 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
primaryTypeDisplayName
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.0170 美元 (每 1,000 次 17.00 美元) |
每次 0.0136 美元 (每 1,000 次 13.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Place Details (進階)
在 Place Details (新版) 要求中使用欄位遮罩或欄位清單,您可以設定 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.020 美元 (每 1,000 次 20.00 美元) |
每個 0.016 美元 (每 1,000 個 16.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Place Details (Preferred)
在 Place Details (新版) 要求中使用欄位遮罩或欄位清單,您可以設定 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
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
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.025 美元 (每 1,000 次 25.00 美元) |
每次 0.020 美元 (每 1,000 次 20.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Nearby Search (基本)
在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
id
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.032 美元 (每 1,000 次 32.00 美元) |
每次 0.0256 美元 (每 1,000 次 25.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Nearby Search (Advanced)
在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.035 美元 (每 1,000 次 35.00 美元) |
每次 0.028 美元 (每 1,000 次 28.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Nearby Search (Preferred)
在 Nearby Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
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
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.040 美元 (每 1,000 次 40.00 美元) |
每次 0.032 美元 (每 1,000 次 32.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Text Search (ID Only)
在 Text Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
id
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每個 0.0 美元 (每 1,000 個 0.00 美元) |
每個 0.0 美元 (每 1,000 個 0.00 美元) |
每個 0.0 美元 (每 1,000 個 0.00 美元) |
SKU:Text Search (Basic)
在 Text Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.032 美元 (每 1,000 次 32.00 美元) |
每次 0.0256 美元 (每 1,000 次 25.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Text Search (Advanced)
在 Text Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.035 美元 (每 1,000 次 35.00 美元) |
每次 0.028 美元 (每 1,000 次 28.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Text Search (Preferred)
在 Text Search (新版) 要求中使用欄位遮罩或欄位清單,您可以將 回應。這個 如果您「只」要求下列欄位,就會觸發 SKU:
Maps JavaScript API Places Library:
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
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.040 美元 (每 1,000 次 40.00 美元) |
每次 0.032 美元 (每 1,000 次 32.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Place Photo
每次向 API 發出要求時,系統都會產生一個 Place Photo SKU。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 $0.007 美元 (每 1,000 次 $7.00 美元) |
每次 $0.0056 美元 (每 1,000 次 $5.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
關於 Autocomplete 工作階段
Autocomplete 工作階段內含一些 Autocomplete 要求 (在使用者輸入時擷取地點相關建議),以及最多一個 Places Details 要求 (在使用者選取特定地點時擷取該地點的相關詳細資料)。系統會傳遞相同的工作階段符記給 Autocomplete 及後續的 Place Detail 要求。工作階段從第一個 Autocomplete 要求開始 (通常在使用者開始輸入時觸發)。使用者選取其中一個 Autocomplete 建議時,系統會發出 Places Details 呼叫。如果使用者未選取任何建議,系統就不會進行 Places Details 呼叫。
使用者選取地點 (即發出 Places Details 呼叫) 之後,您必須使用新的工作階段符記來啟動新的工作階段。
Autocomplete 工作階段可透過下列 API 產生:
- Places API Place Autocomplete 服務或 Maps JavaScript API Places Autocomplete 服務。您必須將應用程式設計為可提供工作階段符記 (可能需要修改現有的程式碼)。
- Maps JavaScript API Autocomplete 小工具。這些小工具會自動啟用按工作階段計費功能,您不需要變更任何程式碼。
工作階段符記適用於單一使用者工作階段,不應用於多個使用者工作階段。假如您重複使用工作階段符記,系統會將工作階段視為無效,並依照未提供工作階段符記的情況收取相關要求費用。
使用工作階段的 Autocomplete 要求和 Places Details 要求會依不同的 SKU 計費。
關於地點介面集資料 SKU
三個地點介面集資料 SKU 如下:Basic Data、Contact Data 和 Atmosphere Data。一或多個資料 SKU 的觸發原因如下:
- Android:每次要求
fetchPlace()
或findCurrentPlace()
時 - iOS:每次呼叫
fetchPlaceFromPlaceID:
或findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
時 - 網路服務:提出每個地點介面集要求時 (視要求中指定的欄位而定)
對於觸發資料 SKU 的要求,除了基本 SKU 以外,系統也一律會針對這類資料 SKU 收費。舉例來說,對於包含 Basic Data 欄位的 Place Details 要求,系統會同時針對 Basic Data SKU「和」Place Details SKU 收費。
如果是網路服務,下列 Places API 呼叫支援指定要傳回的資料欄位:
如果是網路服務,下列 Places API 呼叫「不」支援指定傳回的欄位。這些呼叫一律會傳回所有地點介面集資料,除了每個 API 要求的費用,還會收取三個地點介面集資料 SKU 的費用:
SKU:Basic Data
您可以使用 Place Details 或 Find Place 要求中的欄位參數,將回應限制為僅限指定的欄位。地點介面集要求的基本費用已包含「Basic」類別中的欄位,因此不會產生任何額外費用。要求以下任一欄位都會觸發 Basic Data SKU:
- 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
、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
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
地點介面集要求費用 + 0.00 美元 |
地點介面集要求費用 + 0.00 美元 |
地點介面集要求費用 + 0.00 美元 |
SKU:Contact Data
您可以使用 Place Details 或 Find Place 要求中的欄位參數 (適用於網路服務),或是 Place.Field
的陣列 (適用於 Android 或 iOS),將回應限制為僅限指定的欄位。「Contact」類別中的欄位會產生額外費用。要求以下任一欄位都會觸發 Contact Data SKU:
- 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 美元 (+ 每 1,000 次 3.00 美元) |
地點介面集要求費用 + 每次 0.0024 美元 (+ 每 1,000 次 2.40 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Atmosphere Data
您可以使用 Place Details 或 Find Place 要求中的欄位參數,將回應限制為僅限指定的欄位。「Atmosphere」類別中的欄位會產生額外費用。要求以下任一欄位都會觸發 Atmosphere Data SKU:
- 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_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
、GMSPlaceFieldRating
、GMSPlaceFieldUserRatingsTotal
、GMSPlaceFieldTakeout
、GMSPlaceFieldDelivery
、GMSPlaceFieldDineIn
、GMSPlaceFieldCurbsidePickup
、GMSPlaceFieldReservable
、GMSPlaceFieldServesBreakfast
、GMSPlaceFieldServesLunch
、GMSPlaceFieldServesDinner
、GMSPlaceFieldServesBeer
、GMSPlaceFieldServesWine
、GMSPlaceFieldServesBrunch
或GMSPlaceFieldServesVegetarianFood
。 - JavaScript:請參閱欄位 (Place Details)
- 網路服務:
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 美元 (+ 每 1,000 次 5.00 美元) |
地點介面集要求費用 + 每次 0.004 美元 (+ 每 1,000 次 4.00 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Autocomplete – Per Request
針對以下任何不含工作階段符記的呼叫或要求,系統會以 Autocomplete – Per Request SKU 計費:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript:Maps JavaScript API Place Autocomplete 服務
- 網路服務:Places API Place Autocomplete 服務
針對從無效 Autocomplete 工作階段發出的呼叫 (例如重複使用工作階段符記的工作階段),系統也會以 Autocomplete – Per Request SKU 計費。
針對從 Maps JavaScript API Place Autocomplete 小工具發出的 Autocomplete 要求,如果呼叫來自無效的 Autocomplete 工作階段,系統會以 Autocomplete – Per Request SKU 計費。當使用者在小工具中輸入多個不同的地址,或將不同地址複製貼到小工具,且不一定選取自動預測的建議項目,就有可能會發生這種情況。
每月用量範圍 (每次要求的價格) |
||
---|---|---|
每次 0.00283 美元 (每 1,000 次 2.83 美元) |
每次 0.00227 美元 (每 1,000 次 2.27 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
SKU:Autocomplete without Place Details – Per Session
針對不含 Place Details 要求的 Autocomplete 工作階段 (在工作階段起始的幾分鐘內),系統會以 Autocomplete without Place Details – Per Session SKU 計費。
每月用量範圍 (每個工作階段的價格) |
||
---|---|---|
每次 0.017 美元 (每 1,000 次 17.00 美元) |
每次 0.0136 美元 (每 1,000 次 13.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
範例
如果應用程式在單一工作階段中發出下列兩個呼叫:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
網路服務
- Place Autocomplete 要求 (input=”par”, session_token: XYZ)
- Place Autocomplete 要求 (input=”paris”, session_token: XYZ)
按 SKU 查看帳單時,其中將列出下列 SKU:
- Autocomplete without Place Details – Per Session (價格為每工作階段 0.017 美元起)
SKU:Autocomplete (included with Place Details) – Per Session
針對包含下列任一項目的 Autocomplete 工作階段,系統會以 Autocomplete (included with Place Details) – Per Session SKU 計費:
- Android:呼叫
fetchPlace()
- iOS:呼叫
fetchPlaceFromPlaceID:
- 網路服務:Place Details 要求
Autocomplete 要求本身免付費,但針對後續的 Place Details 呼叫,系統會根據一般 Place Details 定價計費。
Place Details 要求會產生資料 SKU (Basic、Contact 和/或 Atmosphere),視要求中指定的欄位而定。
如果您未在 Place Details 要求中指定欄位,則所有資料 SKU (Basic、Contact 和 Atmosphere) 都會觸發。
對於 Autocomplete 工作階段期間的 Place Details ID 重新整理要求 (僅指定 place_id
欄位的要求),系統會視為 SKU:Autocomplete without Place Details – Per Session 來計費。
每月用量範圍 (每個工作階段的價格) |
||
---|---|---|
$0.00 美元 | $0.00 美元 | $0.00 美元 |
範例
如果您的應用程式在單一工作階段中發出下列三個呼叫:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (附帶
FetchPlaceRequest
,包含地點 ID 和 ADDRESS 欄位)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:(包含地點 ID 和
GMSPlaceFieldFormattedAddress
欄位)
網路服務
- Places Autocomplete 要求 (input=”par”, session_token: XYZ)
- Places Autocomplete 要求 (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
按 SKU 查看帳單時,其中將列出下列 SKU:
- Autocomplete (included with Place Details) – Per Session (以 0.00 美元計費)
- Place Details (價格為每工作階段 0.017 美元起)
- Basic Data (以 0.00 美元計費)
SKU:Query Autocomplete – Per Request
針對下列要求,系統會視為 Query Autocomplete – Per Request SKU 來計費:
- JavaScript:Maps JavaScript API 的 Places Autocomplete 服務 (
getQueryPredictions()
),以及使用 Maps JavaScript API SearchBox 小工具 (使用者輸入內容時,就會產生 Query Autocomplete 要求)。 - 網路服務:Places API Query Autocomplete 服務
每月用量範圍 (每次要求的價格) |
||
---|---|---|
每次 0.00283 美元 (每 1,000 次 2.83 美元) |
每次 0.00227 美元 (每 1,000 次 2.27 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
使用 Query Autocomplete 時,不提供按 Autocomplete 工作階段計價。後續的 Places Details 呼叫會根據一般 Places Details 定價計費。
SKU:Place Details
Place Details 呼叫的計費方式如下:
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.017 美元 (每 1,000 次 17.00 美元) |
每次 0.0136 美元 (每 1,000 次 13.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
下列 API 會產生 Place Details SKU:
- Android:Places SDK for Android (
fetchPlace()
) - iOS:Places SDK for iOS (
fetchPlaceFromPlaceID:
) - JavaScript:Maps JavaScript API Place Details 服務 (
getDetails
) - JavaScript:Maps JavaScript API Place Autocomplete 小工具 (
getPlace
) - JavaScript:Maps JavaScript API Place SearchBox 小工具:如果使用者選取地點結果 (圖示為圖釘),「而不是」查詢 (圖示為放大鏡),系統會呼叫
getPlaces()
方法,請見下圖:使用者在搜尋框內輸入「pizza」(披薩) 後,您可以在搜尋框小工具顯示的結果中看到「Pizza Autentico」(Autentico 披薩店) 旁邊有圖釘圖示,代表這是地點結果 (而不是查詢)。 - 網路服務:Places API Place Details 服務
使用網路 API 和服務時,無論是否提供工作階段符記,系統都會以 Place Details SKU 計費。
Place Details 呼叫或要求也會產生資料 SKU (Basic、Contact 和/或 Atmosphere),視呼叫或要求中指定的欄位而定。如果在 Place Details 呼叫或要求中未指定任何欄位,系統就會觸發所有資料 SKU,並向您收取 Places Details 呼叫或要求的費用,以及所有資料的費用。
範例
- 進行下列其中一項呼叫或要求:
- 行動裝置:在 Android 上呼叫
fetchPlace()
或在 iOS 上呼叫fetchPlaceFromPlaceID:
,且只指定ADDRESS
欄位 - Web API 或服務:發出 Place Details 要求,且只指定地址欄位:
getPlaceDetails(fields: formatted_address)
- Place Details (價格為每工作階段 0.017 美元起)
- Basic Data (以 0.00 美元計費)
- 行動裝置:在 Android 上呼叫
- 進行下列其中一項呼叫或要求:
- 行動裝置:在 Android 上呼叫
fetchPlace()
或在 iOS 上呼叫fetchPlaceFromPlaceID:
,且只指定PHONE_NUMBER
欄位 - Web API 或服務:發出 Place Details 要求,並指定電話號碼欄位:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (價格為每工作階段 0.017 美元起)
- Contact Data (價格為每次要求 0.003 美元起)
- 行動裝置:在 Android 上呼叫
- 進行下列其中一項呼叫或要求:
- 行動裝置:在 Android 上呼叫
fetchPlace()
或在 iOS 上呼叫fetchPlaceFromPlaceID:
,且指定所有欄位 - Web API 或服務:發出 Place Details 要求,且指定所有欄位 (如果您未指定任何欄位,這類要求會採用此預設值):
getPlaceDetails()
。
- Place Details (價格為每工作階段 0.017 美元起)
- Basic Data (以 0.00 美元計費)
- Contact Data (價格為每次要求 0.003 美元起)
- Atmosphere Data (價格為每次要求 0.005 美元起)
- 行動裝置:在 Android 上呼叫
SKU:Place Details – ID Refresh
使用 Place Details 要求重新整理過時的地點 ID。這類要求為免付費。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
$0.00 美元 | $0.00 美元 | $0.00 美元 |
範例
發出 Place Details 要求,且只指定地點 ID 欄位:getPlaceDetails(fields: place_id)
。按 SKU 查看帳單時,其中將列出下列 SKU:
- Place Details – ID Refresh (以 0.00 美元計費)
SKU:Find Place
針對 Find Place 要求,系統會以 Find Place 計費。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.017 美元 (每 1,000 次 17.00 美元) |
每次 0.0136 美元 (每 1,000 次 13.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
Find Place 要求也會產生資料 SKU (Basic、Contact 和/或 Atmosphere),視要求中指定的欄位而定。與 Place Details 要求一樣,您可以使用 Find Place 要求中的欄位參數,將回應限制為僅限指定的欄位。系統會向您收取 Find Place 要求及相關要求資料的費用。根據預設,如果您未要求任何欄位,則系統只會傳回地點 ID,因此不會產生額外的資料費用。
範例
- 您發出 Find Place 要求,且只指定地址欄位:
FindPlace(fields: formatted_address)
。按 SKU 查看帳單時,其中將列出下列 SKU:- Find Place (價格為每次呼叫 0.017 美元起)
- Basic Data (以 0.00 美元計費)
- 您發出 Find Place 要求,並指定電話號碼欄位:
FindPlace(fields: formatted_phone_number)
。按 SKU 查看帳單時,其中將列出下列 SKU:- Find Place (價格為每次呼叫 0.017 美元起)
- Contact Data (價格為每次要求 0.003 美元起)
- 您發出 Find Place 要求,並指定全部三個資料類型值區的欄位:
FindPlace(fields: formatted_address, opening_hours, price_level)
。按 SKU 查看帳單時,其中將列出下列 SKU:- Find Place (價格為每次呼叫 0.017 美元起)
- Basic Data (以 0.00 美元計費)
- Contact Data (價格為每次要求 0.003 美元起)
- 氣氛資料 (價格為每次要求 0.005 美元起)
SKU:Find Place – ID only
針對只指定要傳回特定地點 ID 的 Find Place 要求,系統會以 Find Place – ID only 計費。根據預設,如果 Find Place 要求中未指定任何欄位,系統只會傳回地點 ID。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
$0.00 美元 | $0.00 美元 | $0.00 美元 |
範例
您發出 Find Place 要求,且只指定 place_id
欄位:FindPlace(fields: place_id)
。
按 SKU 查看帳單時,其中將列出下列 SKU:
- Find Place – ID only (以 0.00 美元計費)
SKU:Place – Nearby Search
針對向 Maps JavaScript API Place Nearby Search 服務 (nearbySearch()
) 或 Places API Nearby Search 服務提出的要求,系統會以 Place – Nearby Search 計費
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.032 美元 (每 1,000 次 32.00 美元) |
每次 0.0256 美元 (每 1,000 次 25.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
Nearby Search 要求會傳回地點清單,但不支援指定傳回特定欄位。Nearby Search 要求會傳回支援的資料欄位子集。系統會向您收取 Nearby Search 要求的費用 (價格為每次 0.032 美元起),以及所有資料類型 SKU (Basic Data、Contact Data 和 Atmosphere Data) 的費用。
範例
您發出 Nearby Search 要求,例如 NearbySearch (San Francisco, 100 meters)
。
按 SKU 查看帳單時,其中將列出下列 SKU:
- Place - Nearby Search (價格為每次呼叫 0.032 美元起)
- Basic Data (以 0.00 美元計費)
- Contact Data (價格為每次要求 0.003 美元起)
- Atmosphere Data (價格為每次要求 0.005 美元起)
SKU:Place – Text Search
針對向 Maps JavaScript API Place Text Search 服務 (textSearch()
) 或 Places API Text Search 服務提出的要求,系統會以 Place – Text Search 計費。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 0.032 美元 (每 1,000 次 32.00 美元) |
每次 0.0256 美元 (每 1,000 次 25.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
Text Search 要求會傳回地點清單,但不支援指定傳回特定欄位。Text Search 要求會傳回支援的資料欄位子集。系統會向您收取 Text Search 要求的費用 (價格為每次 0.032 美元起),以及所有資料類型 SKU (Basic Data、Contact Data 和 Atmosphere Data) 的費用。
Maps JavaScript API Place SearchBox 小工具也會產生 Place – Text Search SKU:如果使用者選取地點查詢 (圖示為放大鏡),而不是結果項目 (圖示為圖釘),系統會呼叫 getPlaces()
方法,請見下圖:
![Places Details SearchBox 小工具查詢選項](https://developers.google.cn/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=6&hl=zh-tw)
範例
您發出 Text Search 要求,例如 TextSearch(123 Main Street)
。按 SKU 查看帳單時,其中將列出下列 SKU:
- Place - Text Search (價格為每次呼叫 0.032 美元起)
- Basic Data (以 0.00 美元計費)
- Contact Data (價格為每次要求 0.003 美元起)
- Atmosphere Data (價格為每次要求 0.005 美元起)
SKU:Place Photo
針對下列項目,系統會視為 Place Photo SKU 來計費:
- Android:呼叫
fetchPhoto()
- iOS:呼叫
loadPlacePhoto:
- JavaScript:向
PlacePhoto.getUrl()
傳回的網址要求載入圖片像素資料時,呼叫 Maps JavaScript API Places Library 的 Place Photos 服務 - 網路服務:傳送至 Places API Place Photos 服務的要求
如果是 JavaScript 服務,叫用 PlacePhoto.getUrl()
方法並不會產生帳單費用,除非將網址實際用於取得像素資料。
每月用量範圍 (每次呼叫的價格) |
||
---|---|---|
每次 $0.007 美元 (每 1,000 次 $7.00 美元) |
每次 $0.0056 美元 (每 1,000 次 $5.60 美元) |
請聯絡銷售人員洽詢高用量定價資訊 |
JavaScript 服務定價
JavaScript 服務另外計價。詳情請參閱服務的「用量與計費」頁面:
- 路線服務 -- Directions API 用量與計費
- 距離矩陣服務 -- Distance Matrix API 用量與計費
- 海拔高度服務 -- Elevation API 用量與計費
- 地理編碼服務 -- Geocoding API 用量與計費
- 街景服務 -- Street View API 用量與計費
其他用量限制
雖然每日要求數量沒有上限,但下列是 Maps JavaScript API 設有使用限制:
- 每分鐘 30,000 次查詢 (每分鐘的要求數量)。
- 每個 IP 位址每分鐘 300 次查詢 (每分鐘的要求數量)。在 Google Cloud 控制台中,這個配額稱為「每位使用者每分鐘地圖載入量」。
Maps JavaScript 中的擬真 3D 地圖使用限制
Maps JavaScript 的擬真成像 3D 地圖有以下使用限制
- 每分鐘 100 次查詢 (每分鐘的要求數量)。
- 每個 IP 位址每分鐘 10 次查詢 (每分鐘的要求數量)。
使用條款限制
如需許可用途的完整詳細資料,請參閱《Google 地圖平台服務條款》中的「授權限制」一節。
管理使用成本
如要管理 Maps JavaScript API 的使用成本,或是符合對實際執行環境流量的需求,您可以針對傳送至API 的所有要求,設定每日配額限制。系統會在太平洋時間凌晨 12 點重設每日配額。
如要查看或變更 Maps JavaScript API 的配額限制,請按照下列步驟操作:
- 在 Cloud 控制台中,開啟 Google 地圖平台「配額」頁面。
- 按一下 API 下拉式選單,然後選取「Maps JavaScript API」。
- 如要查看配額限制,請向下捲動至「要求」資訊卡。
表格會顯示配額名稱和限制。 - 如要變更配額限制,請按一下該限制的「編輯」圖示。
在隨即顯示的對話方塊中,於「配額限制」欄位中依需求輸入每日可計費配額上限。如果 Google 已指定配額上限,則您自訂的上限無法超過該限制。接著選取「儲存」。
假如某天的 API 用量達到可計費配額上限,在當天剩餘時間內,應用程式將無法存取 API。