Cara penagihan Places API
Places API (Baru) dan Places API menggunakan model harga bayar sesuai penggunaan. API dan SDK Google Maps Platform ditagih berdasarkan SKU. Penggunaan dilacak untuk setiap SKU, dan setiap API atau SDK dapat memiliki lebih dari satu SKU produk. Biaya dihitung berdasarkan:
Gunakan kalkulator Harga dan Penggunaan kami untuk memperkirakan biaya penggunaan Anda per API atau SDK. Untuk SKU Google Maps Platform yang memenuhi syarat, kredit Google Maps Platform senilai $200 USD tersedia setiap bulan untuk setiap akun penagihan. Kredit ini otomatis diterapkan ke SKU yang memenuhi syarat.
Harga untuk Places API (Baru)
Tentang mask kolom
Untuk Place Details (Baru),
Nearby Search (Baru), dan
Text Search (Baru), gunakan header FieldMask
dalam
permintaan API untuk menentukan daftar kolom yang akan ditampilkan dalam respons. Anda akan ditagih dengan SKU tertinggi yang berlaku untuk permintaan Anda. Artinya, jika Anda memilih kolom di SKU (Basic) dan SKU (Advanced), Anda akan ditagih berdasarkan SKU (Advanced).
Penggunaan penyamaran kolom merupakan praktik desain yang baik untuk memastikan Anda tidak meminta data yang tidak diperlukan. Cara ini akan membantu Anda menghindari waktu pemrosesan dan biaya penagihan yang tidak perlu.
Tentang sesi Autocomplete (Baru)
Sesi Autocomplete (Baru) mencakup satu atau beberapa permintaan Autocomplete (Baru), dan permintaan Place Details (Baru) atau permintaan Validasi Alamat. Token sesi yang sama diteruskan ke permintaan Autocomplete (Baru) dan ke permintaan Place Details (Baru) atau permintaan Validasi Alamat berikutnya.
Sesi dimulai dengan permintaan Autocomplete (Baru) pertama. Permintaan Place Details (Baru) atau Permintaan Validasi Alamat akan dibuat saat pengguna telah memilih salah satu saran Autocomplete (Baru). Jika sesi diabaikan, yang berarti tidak ada permintaan Place Details (Baru) atau permintaan Validasi Alamat yang dibuat, permintaan Autocomplete (Baru) akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.
Setelah pengguna memilih tempat (artinya permintaan Place Details (Baru) atau permintaan Validasi Alamat dibuat), Anda harus memulai sesi baru menggunakan token sesi baru.
Token sesi cocok untuk satu sesi dan tidak dapat digunakan untuk lebih dari satu sesi. Jika token sesi digunakan ulang, sesi tersebut dianggap tidak valid dan permintaan akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.
SKU: Permintaan Autocomplete
SKU Autocomplete Requests dikenai biaya untuk setiap permintaan ke Autocomplete API (Baru) yang tidak menyertakan token sesi.
Anda juga akan dikenai biaya jika menggunakan token sesi dan:
- Hentikan sesi dengan satu permintaan ke Place Details (Baru) yang
meminta kolom apa pun yang ditentukan oleh SKU: Place Details (Location Only).
- Setiap permintaan Autocomplete (Baru), hingga 12 permintaan, akan ditagih menggunakan SKU: Permintaan Autocomplete.
- Setiap permintaan Autocomplete (Baru) berikutnya akan ditagih menggunakan SKU: Autocomplete Session Usage.
- Tinggalkan sesi atau akhiri sesi dengan melakukan panggilan ke SKU: Place Details (IDs Only). Semua permintaan Autocomplete (Baru) kemudian ditagih menggunakan SKU: Permintaan Autocomplete.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,00283 per 1 permintaan (USD2,83 per 1.000) |
USD0,00227 per 1 permintaan (USD2,27 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Penggunaan Sesi Autocomplete
SKU Autocomplete Session Usage dikenai biaya untuk setiap permintaan ke Autocomplete API (Baru) yang menyertakan token sesi.
SKU ini dikenai biaya dalam skenario berikut:
Sesi Autocomplete dihentikan dengan panggilan ke SKU: Place Details (Location Only):
- Setiap permintaan Autocomplete (Baru), hingga 12 permintaan, akan ditagih menggunakan SKU: Permintaan Autocomplete.
- Setiap permintaan Autocomplete (Baru) berikutnya akan ditagih menggunakan SKU: Autocomplete Session Usage.
Sesi Autocomplete dihentikan dengan panggilan ke SKU: Place Details (Basic, Advanced, atau Preferred).
Panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred) akan ditagih di SKU: Place Details (Preferred).
Sesi Autocomplete dihentikan dengan panggilan ke SKU: Address Validation Preferred.
Untuk mengetahui informasi selengkapnya, lihat Pelengkapan otomatis (Baru) dan harga sesi.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,00 per 1 panggilan (USD0,00 per 1.000) |
USD0,00 per 1 panggilan (USD0,00 per 1.000) |
USD0,00 per 1 panggilan (USD0,00 per 1.000) |
SKU: Place Details (IDs Only)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Place Details (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
attributions
,
id
,
name
*,
photos
* Kolom name
berisi nama resource tempat
dalam bentuk: places/PLACE_ID
. Gunakan displayName
untuk mengakses nama tekstual tempat tersebut.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
SKU: Place Details (Hanya Lokasi)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Place Details (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
shortFormattedAddress
,
types
,
viewport
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,005 per 1 permintaan (USD5,00 per 1.000) |
USD0,004 per 1 permintaan (USD4,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Place Details (Basic)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Place Details (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
iconMaskBaseUri
,
primaryType
,
primaryTypeDisplayName
,
subDestinations
,
utcOffsetMinutes
Jika sesi Autocomplete dihentikan oleh panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred), panggilan akan ditagih di SKU: Place Details (Preferred). Untuk mengetahui informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,0170 per 1 panggilan (USD17,00 per 1.000) |
USD0,0136 per 1 panggilan (USD13,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Place Details (Advanced)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Place Details (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
currentOpeningHours
,
currentSecondaryOpeningHours
,
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
regularSecondaryOpeningHours
,
userRatingCount
,
websiteUri
Jika sesi Autocomplete dihentikan oleh panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred), panggilan akan ditagih di SKU: Place Details (Preferred). Untuk mengetahui informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,020 per 1 panggilan (USD20,00 per 1.000) |
USD0,016 per 1 panggilan (USD16,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Place Details (Preferred)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Place Details (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
allowsDogs
,
curbsidePickup
,
delivery
,
dineIn
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
goodForChildren
,
goodForGroups
,
goodForWatchingSports
,
liveMusic
,
menuForChildren
,
parkingOptions
,
paymentOptions
,
restroom
,
reservable
,
restroom
,
reviews
,
reviews
outdoorSeating
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Jika sesi Autocomplete dihentikan oleh panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred), panggilan akan ditagih di SKU: Place Details (Preferred). Untuk mengetahui informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,025 per 1 panggilan (USD25,00 per 1.000) |
USD0,020 per 1 panggilan (USD20,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Nearby Search (Basic)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Nearby Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.attributions
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.id
,
places.location
,
places.name
*,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
places.name
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
places/PLACE_ID
Gunakan places.displayName
untuk mengakses nama tekstual tempat tersebut.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
USD0,0256 per 1 panggilan (USD25,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Nearby Search (Advanced)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Nearby Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,035 per 1 panggilan (USD35,00 per 1.000) |
USD0,028 per 1 panggilan (USD28,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Nearby Search (Preferred)
Dengan menggunakan mask kolom atau daftar kolom di permintaan Nearby Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
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.restroom
,
places.reservable
,
places.restroom
,
places.reviews
,
places.reviews
places.outdoorSeating
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,040 per 1 panggilan (USD40,00 per 1.000) |
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Text Search (ID Only)
Dengan menggunakan mask kolom atau daftar kolom dalam permintaan Text Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
places.attributions
,
places.id
,
places.name
*,
nextPageToken
* Kolom places.name
berisi nama resource tempat
dalam bentuk: places/PLACE_ID
. Gunakan places.displayName
untuk mengakses nama tekstual tempat tersebut.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
USD0,0 per 1 panggilan (USD0,00 per 1.000) |
SKU: Text Search (Basic)
Dengan menggunakan mask kolom atau daftar kolom dalam permintaan Text Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
places.accessibilityOptions
,
places.addressComponents
,
places.adrFormatAddress
,
places.businessStatus
,
places.displayName
,
places.formattedAddress
,
places.googleMapsUri
,
places.iconBackgroundColor
,
places.iconMaskBaseUri
,
places.location
,
places.photos
,
places.plusCode
,
places.primaryType
,
places.primaryTypeDisplayName
,
places.shortFormattedAddress
,
places.subDestinations
,
places.types
,
places.utcOffsetMinutes
,
places.utcOffsetMinutes
places.viewport
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
USD0,0256 per 1 panggilan (USD25,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Text Search (Advanced)
Dengan menggunakan mask kolom atau daftar kolom dalam permintaan Text Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
places.currentOpeningHours
,
places.currentSecondaryOpeningHours
,
places.internationalPhoneNumber
,
places.nationalPhoneNumber
,
places.priceLevel
,
places.rating
,
places.regularOpeningHours
,
places.regularSecondaryOpeningHours
,
places.userRatingCount
,
places.websiteUri
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,035 per 1 panggilan (USD35,00 per 1.000) |
USD0,028 per 1 panggilan (USD28,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Text Search (Preferred)
Dengan menggunakan mask kolom atau daftar kolom dalam permintaan Text Search (Baru), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:
Layanan web:
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.restroom
,
places.reservable
,
places.restroom
,
places.reviews
,
places.reviews
places.outdoorSeating
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,040 per 1 panggilan (USD40,00 per 1.000) |
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Place Photo
SKU Place Photo dikenai biaya untuk setiap permintaan ke API.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,007 per 1 panorama (USD7,00 per 1.000) |
USD0,0056 per 1 panorama (USD5,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Harga untuk Places API
Tentang sesi Autocomplete
Sesi Autocomplete mencakup beberapa permintaan Autocomplete (untuk mendapatkan saran tempat saat pengguna mengetik), dan maksimal satu permintaan Places Details (untuk mendapatkan detail tempat yang dipilih oleh pengguna). Token sesi yang sama diteruskan ke Autocomplete dan permintaan Place Detail berikutnya. Sesi diawali dengan permintaan Autocomplete pertama (yang biasanya terjadi saat pengguna mulai mengetik). Panggilan Places Details dilakukan saat pengguna telah memilih salah satu saran Autocomplete. Jika saran tidak dipilih, panggilan Places Details tidak akan dilakukan.
Setelah pengguna memilih tempat (yaitu, panggilan Places Details dilakukan), Anda harus memulai sesi baru menggunakan token sesi baru.
Sesi Autocomplete dapat dibuat dari API berikut:
- Layanan Place Autocomplete Places API atau Layanan Places Autocomplete Maps JavaScript API. Anda harus mendesain aplikasi untuk menyediakan token sesi (Anda mungkin perlu mengubah kode yang ada).
- Widget Autocomplete Maps JavaScript API. Penagihan berbasis sesi diaktifkan otomatis pada widget tersebut, tanpa perlu mengubah kode.
Token sesi cocok untuk satu sesi pengguna dan tidak dapat digunakan untuk lebih dari satu sesi pengguna. Jika token sesi digunakan ulang, sesi tersebut dianggap tidak valid dan permintaan akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.
Permintaan Autocomplete dan Places Details yang menggunakan sesi ditagih berdasarkan SKU yang berbeda.
Tentang SKU Data Tempat
Tiga SKU Data Tempat adalah: Basic Data, Contact Data, dan Atmosphere Data.Satu atau beberapa SKU Data terpicu untuk:
- Android: setiap permintaan ke
fetchPlace()
ataufindCurrentPlace()
- iOS: setiap panggilan ke
fetchPlaceFromPlaceID:
ataufindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- Layanan web: setiap permintaan Tempat bergantung pada kolom yang ditentukan dalam permintaan
SKU Data selalu dikenai biaya selain SKU dasar untuk permintaan yang memicunya. Misalnya, permintaan Place Details yang menyertakan kolom Basic Data akan dikenai biaya berdasarkan SKU Basic Data dan SKU Place Details.
Untuk layanan web, panggilan Places API berikut mendukung penetapan kolom data yang ditampilkan:
Untuk layanan web, panggilan Places API berikut TIDAK mendukung penetapan kolom yang ditampilkan. Panggilan ini selalu menampilkan semua data Tempat, yang menagih biaya untuk tiga SKU Data Tempat selain biaya untuk setiap permintaan API:
SKU: Basic Data
Dengan parameter kolom dalam permintaan Place Details atau Find Place, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Basic tercakup dalam biaya dasar permintaan Places dan tidak akan dikenai biaya tambahan. SKU Basic Data terpicu jika ada permintaan untuk kolom berikut:
-
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
, atauPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
,GMSPlaceFieldBusinessStatus
,GMSPlaceFieldID
,GMSPlaceFieldCoordinate
,GMSPlaceFieldName
,GMSPlaceFieldPhotos
,GMSPlaceFieldPlusCode
,GMSPlaceFieldTypes
, atauGMSPlaceFieldViewport
-
Layanan web:
address_component
,adr_address
,business_status
,formatted_address
,geometry
,icon
,name
,permanently_closed
,photo
,place_id
,plus_code
,type
,url
,utc_offset
,vicinity
, atauwheelchair_accessible_entrance
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
Biaya permintaan Tempat + USD0,00 |
Biaya permintaan Tempat + USD0,00 |
Biaya permintaan Tempat + 0,00 USD |
SKU: Contact Data
Dengan parameter kolom dalam permintaan Place Details atau Find Place untuk layanan web, atau
array Place.Field
untuk Android atau iOS, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Contact akan dikenai biaya tambahan. SKU Contact Data terpicu jika ada permintaan untuk kolom berikut:
-
Android:
Place.Field.CURRENT_OPENING_HOURS
,Place.Field.OPENING_HOURS
,Place.Field.PHONE_NUMBER
,Place.Field.SECONDARY_OPENING_HOURS
, atauPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
,GMSPlaceFieldPhoneNumber
, atauGMSPlaceFieldWebsite
-
Layanan web:
formatted_phone_number
,international_phone_number
,opening_hours
,current_opening_hours
,secondary_opening_hours
, atauwebsite
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
Biaya permintaan Tempat + 0,003 USD per 1 panggilan (+ 3,00 USD per 1.000) |
Biaya permintaan Tempat + 0,0024 USD per 1 panggilan (+ 2,40 USD per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Atmosphere Data
Dengan parameter kolom dalam permintaan Place Details atau Find Place, Anda dapat membatasi respons hanya untuk kolom yang telah ditentukan. Kolom pada kategori Atmosphere akan dikenai biaya tambahan. SKU Atmosphere Data terpicu jika ada permintaan untuk kolom berikut:
- 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
, atauPlace.Field.USER_RATINGS_TOTAL
- iOS:
GMSPlaceFieldPriceLevel
,GMSPlaceFieldRating
,GMSPlaceFieldUserRatingsTotal
,GMSPlaceFieldTakeout
,GMSPlaceFieldDelivery
,GMSPlaceFieldDineIn
,GMSPlaceFieldCurbsidePickup
,GMSPlaceFieldReservable
,GMSPlaceFieldServesBreakfast
,GMSPlaceFieldServesLunch
,GMSPlaceFieldServesDinner
,GMSPlaceFieldServesBeer
,GMSPlaceFieldServesWine
,GMSPlaceFieldServesBrunch
, atauGMSPlaceFieldServesVegetarianFood
. - JavaScript: Lihat Kolom (Place Details)
- Layanan web:
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
, atauuser_ratings_total
.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
Biaya permintaan Tempat + 0,005 USD per 1 panggilan (+ 5,00 USD per 1.000) |
Biaya permintaan Tempat + 0,004 USD per 1 panggilan (+ 4,00 USD per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Autocomplete – Per Request
SKU Autocomplete – Per Request dikenai biaya untuk panggilan atau permintaan apa pun yang tidak menyertakan token sesi:
- Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: layanan Place Autocomplete Maps JavaScript API
- Layanan web: layanan Place Autocomplete di Places API
Panggilan yang dilakukan dari sesi Autocomplete yang tidak valid (misalnya, sesi yang menggunakan ulang token sesi) juga dikenai biaya untuk SKU Autocomplete – Per Request.
Permintaan Autocomplete dari Widget Place Autocomplete Maps JavaScript API mungkin dikenai biaya SKU Autocomplete – Per Request jika panggilan dilakukan dari sesi Autocomplete yang tidak valid. Hal ini dapat terjadi saat pengguna mengetik beberapa alamat berbeda atau menyalin/menempel alamat berbeda ke widget dan tidak selalu memilih prediksi pelengkapan otomatis.
RENTANG VOLUME BULANAN (Harga per PERMINTAAN) |
||
---|---|---|
USD0,00283 per 1 permintaan (USD2,83 per 1.000) |
USD0,00227 per 1 permintaan (USD2,27 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU: Autocomplete without Place Details – Per Session
SKU Autocomplete without Place Details – Per Session dikenai biaya untuk sesi Autocomplete yang tidak menyertakan permintaan Place Details (dalam waktu beberapa menit pada awal sesi).
RENTANG VOLUME BULANAN (Harga per SESI) |
||
---|---|---|
USD0,017 per 1 permintaan (USD17,00 per 1.000) |
USD0,0136 per 1 permintaan (USD13,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Contoh
Jika aplikasi Anda melakukan dua panggilan berikut dalam satu sesi:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
Layanan web
- Permintaan Place Autocomplete (input=”par”, session_token: XYZ)
- Permintaan Place Autocomplete (input=”paris”, session_token: XYZ)
Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
- Autocomplete without Place Details – Per Session (harga mulai dari USD0,017 per sesi)
SKU: Autocomplete (included with Place Details) – Per Session
SKU Autocomplete (included with Place Details) – Per Session dikenai biaya untuk sesi Autocomplete yang menyertakan salah satu dari:
- Android: panggilan ke
fetchPlace()
- iOS: panggilan ke
fetchPlaceFromPlaceID:
- Layanan web: permintaan Place Details
Permintaan Autocomplete tersedia tanpa biaya, dan panggilan Place Details selanjutnya akan dikenai biaya berdasarkan harga Place Details reguler.
Permintaan Place Details menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere) – bergantung pada kolom yang ditentukan dalam permintaan.
Jika Anda tidak menentukan kolom dalam permintaan Place Details, semua SKU Data akan terpicu (Basic, Contact, dan Atmosphere).
Permintaan pembaruan ID Place Details (permintaan yang hanya menentukan kolom place_id
)
selama sesi pelengkapan otomatis akan ditagih sebagai SKU: Autocomplete
without Place Details – Per Session.
RENTANG VOLUME BULANAN (Harga per SESI) |
||
---|---|---|
USD0,00 | USD0,00 | USD0,00 |
Contoh
Jika aplikasi Anda melakukan tiga panggilan berikut dalam satu sesi:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (dengan
FetchPlaceRequest
yang menyertakan ID Tempat dan kolom ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(yang menyertakan ID Tempat dan kolom
GMSPlaceFieldFormattedAddress
)
Layanan web
- Permintaan Places Autocomplete (input=”par”, session_token: XYZ)
- Permintaan Places Autocomplete (input=”paris”, session_token: XYZ)
- Places Details (place_id, session_token: XYZ, fields:formatted_address)
Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
- Autocomplete (disertakan dengan Place Details) – Per Session (dikenai biaya USD0,00)
- Place Details (harga mulai dari USD0,017 per sesi)
- Basic Data (dikenai biaya USD0,00)
SKU: Query Autocomplete – Per Request
SKU Query Autocomplete – Per Request dikenai biaya untuk setiap permintaan ke:
- JavaScript:
layanan Places Autocomplete Maps JavaScript API (
getQueryPredictions()
) dan penggunaan widget SearchBox Maps JavaScript API (permintaan Query Autocomplete dibuat saat pengguna mengetik). - Layanan web: layanan Query Autocomplete Places API
RENTANG VOLUME BULANAN (Harga per PERMINTAAN) |
||
---|---|---|
USD0,00283 per 1 permintaan (USD2,83 per 1.000) |
USD0,00227 per 1 permintaan (USD2,27 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Harga menurut sesi Autocomplete tidak didukung menggunakan Query Autocomplete. Panggilan Places Details selanjutnya akan dikenai biaya berdasarkan harga Places Details reguler.
SKU: Place Details
Biaya yang dikenai untuk panggilan Place Details adalah sebagai berikut:
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,017 per 1 permintaan (USD17,00 per 1.000) |
USD0,0136 per 1 permintaan (USD13,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
SKU Place Details dihasilkan dari API berikut:
- Android: Places SDK for Android (
fetchPlace()
) - iOS: Places SDK for iOS (
fetchPlaceFromPlaceID:
) - JavaScript:
layanan Place Details Maps JavaScript API (
getDetails
) - JavaScript:
widget Place Autocomplete Maps JavaScript API (
getPlace
) - JavaScript:
widget Place SearchBox Maps JavaScript API: Metode
getPlaces()
setelah pengguna memilih hasil tempat (ikon: pin), *bukan* kueri (ikon: pembesar), seperti yang diilustrasikan di sini:Pada hasil widget kotak penelusuran, setelah mengetik "pizza" di kotak penelusuran, perhatikan bahwa Pizza Autentico memiliki ikon pin di sampingnya, yang menunjukkan bahwa kueri ini adalah tempat{/0). (dan bukan kueri tempat{/0). - Layanan web: layanan Place Details Places API
Dengan API dan layanan web, SKU Place Details akan dikenai biaya, baik token sesi diberikan atau tidak.
Panggilan atau permintaan Place Details juga menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere), bergantung pada kolom yang ditentukan dalam panggilan atau permintaan tersebut. Jika NO kolom yang ditentukan dalam panggilan atau permintaan Place Details, NO SKU Data akan terpicu, dan Anda akan dikenai biaya untuk panggilan atau permintaan Place Details ditambah biaya semua data.
Contoh
- Lakukan salah satu panggilan atau permintaan berikut:
- Seluler: memanggil
fetchPlace()
di Android ataufetchPlaceFromPlaceID:
di iOS, dan hanya menentukan kolomADDRESS
- API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom alamat:
getPlaceDetails(fields: formatted_address)
- Place Details (harga mulai dari USD0,017 per sesi)
- Basic Data (dikenai biaya USD0,00)
- Seluler: memanggil
- Lakukan salah satu panggilan atau permintaan berikut:
- Seluler: memanggil
fetchPlace()
di Android ataufetchPlaceFromPlaceID:
di iOS, dan hanya menentukan kolomPHONE_NUMBER
- API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom nomor telepon:
getPlaceDetails(fields: formatted_phone_number)
- Place Details (harga mulai dari USD0,017 per sesi)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Seluler: memanggil
- Lakukan salah satu panggilan atau permintaan berikut:
- Seluler: memanggil
fetchPlace()
di Android ataufetchPlaceFromPlaceID:
di iOS, dan menentukan semua kolom - API atau layanan web: mengirimkan permintaan Place Details dan menentukan semua kolom (ini merupakan setelan default untuk jenis permintaan ini jika Anda tidak menentukan kolom):
getPlaceDetails()
.
- Place Details (harga mulai dari USD0,017 per sesi)
- Basic Data (dikenai biaya USD0,00)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Atmosphere Data (harga mulai dari USD0,005 per permintaan)
- Seluler: memanggil
SKU: Place Details – ID Refresh
Gunakan permintaan Place Details untuk memperbarui ID tempat yang lama. Jenis permintaan ini tersedia tanpa biaya.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,00 | USD0,00 | USD0,00 |
Contoh
Kirimkan permintaan Place Details dengan menentukan hanya kolom ID tempat:
getPlaceDetails(fields: place_id)
.
Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat
melihat tagihan berdasarkan SKU):
- Place Details – ID Refresh (dikenai biaya USD0,00)
SKU: Find Place
Find Place dikenai biaya untuk permintaan Find Place.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,017 per 1 permintaan (USD17,00 per 1.000) |
USD0,0136 per 1 permintaan (USD13,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Permintaan Find Place juga menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere), bergantung pada kolom yang ditentukan dalam permintaan. Sama seperti permintaan Place Details, Anda dapat menggunakan parameter kolom dalam permintaan Find Place guna membatasi respons hanya untuk kolom yang telah ditentukan. Anda akan dikenai biaya untuk permintaan Find Place dan data yang diminta. Secara default, jika NO kolom yang diminta, hanya ID tempat yang akan ditampilkan, sehingga tidak menimbulkan biaya data tambahan.
Contoh
- Anda mengirimkan permintaan Find Place dan menentukan hanya kolom alamat:
FindPlace(fields: formatted_address)
. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):- Find Place (harga mulai dari USD0,017 per panggilan)
- Basic Data (dikenai biaya USD0,00)
- Anda mengirimkan permintaan Find Place dan menentukan kolom nomor telepon:
FindPlace(fields: formatted_phone_number)
. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):- Find Place (harga mulai dari USD0,017 per panggilan)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Anda mengirimkan permintaan Find Place dan menentukan kolom dari ketiga kumpulan jenis data:
FindPlace(fields: formatted_address, opening_hours, price_level)
. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):- Find Place (harga mulai dari USD0,017 per panggilan)
- Basic Data (dikenai biaya USD0,00)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Atmosphere Data (harga mulai dari 0,005 USD per permintaan)
SKU: Find Place – ID only
Find Place – ID only dikenai biaya untuk permintaan Find Place yang hanya menentukan ID Tempat untuk ditampilkan. Secara default, jika tidak ada kolom yang ditentukan dalam permintaan Find Place, hanya ID tempat yang akan ditampilkan.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,00 | USD0,00 | USD0,00 |
Contoh
Anda mengirimkan permintaan Find Place dan hanya menentukan kolom place_id
: FindPlace(fields: place_id)
.
Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
- Find Place – ID only (dikenai biaya 0,00 USD)
SKU: Place – Nearby Search
Place – Nearby Search dikenai biaya untuk permintaan ke
layanan Place Nearby Search Maps JavaScript API
(nearbySearch()
), atau ke
layanan Nearby Search Places API
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
USD0,0256 per 1 panggilan (USD25,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Permintaan Nearby Search menampilkan daftar tempat, tetapi tidak mendukung penetapan kolom yang ditampilkan. Permintaan Nearby Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya permintaan Nearby Search dengan harga mulai dari USD0,032 per permintaan, serta semua SKU jenis data (Basic Data, Contact Data, dan Atmosphere Data).
Contoh
Anda mengirimkan permintaan Nearby Search, seperti NearbySearch (San Francisco, 100 meters)
.
Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
- Place - Nearby Search (harga mulai dari USD0,032 per panggilan)
- Basic Data (dikenai biaya USD0,00)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Atmosphere Data (harga mulai dari USD0,005 per permintaan)
SKU: Place – Text Search
Place – Text Search dikenai biaya untuk permintaan ke layanan Place Text Search Maps JavaScript API (textSearch()
), atau ke Layanan Text Search Places API.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,032 per 1 panggilan (USD32,00 per 1.000) |
USD0,0256 per 1 panggilan (USD25,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Permintaan Text Search menampilkan daftar tempat, tetapi tidak mendukung penentuan kolom yang ditampilkan. Permintaan Text Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya permintaan Text Search dengan harga mulai dari USD0,032 per permintaan, serta semua SKU jenis data (Basic Data, Contact Data, dan Atmosphere Data).
SKU Place – Text Search juga dibuat dengan metode
widget Place SearchBox Maps JavaScript API: getPlaces()
setelah pengguna memilih kueri tempat (ikon: kaca pembesar), bukan hasil
(ikon: pin), seperti yang digambarkan sebagai berikut:
![Pilihan Kueri Widget Kotak Penelusuran Place Details](https://developers.google.cn/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=8&hl=id)
Contoh
Anda mengirimkan permintaan Text Search, seperti TextSearch(123 Main Street)
. Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
- Place - Text Search (harga mulai dari USD0,032 per panggilan)
- Basic Data (dikenai biaya USD0,00)
- Contact Data (harga mulai dari USD0,003 per permintaan)
- Atmosphere Data (harga mulai dari USD0,005 per permintaan)
SKU: Place Photo
SKU Place Photo dikenai biaya untuk:
- Android:: panggilan ke
fetchPhoto()
- iOS:: panggilan ke
loadPlacePhoto:
- JavaScript: Permintaan ke layanan Place Photos pada Places Library,
Maps JavaScript API saat meminta data dari URL yang ditampilkan oleh
PlacePhoto.getUrl()
untuk memuat data piksel gambar - Layanan web: permintaan ke layanan Place Photos Places API
Untuk layanan JavaScript, pemanggilan metode PlacePhoto.getUrl()
tidak akan
menimbulkan penagihan hingga URL-nya benar-benar digunakan untuk mendapatkan data piksel.
RENTANG VOLUME BULANAN (Harga per PANGGILAN) |
||
---|---|---|
USD0,007 per 1 panorama (USD7,00 per 1.000) |
USD0,0056 per 1 panorama (USD5,60 per 1.000) |
Hubungi Bagian Penjualan untuk mengetahui harga volume |
Batas penggunaan lainnya
Meskipun tidak ada jumlah maksimum permintaan per hari, batas penggunaan berikut tetap berlaku:
Places API (Baru): Batas kapasitas adalah 600 QPM (permintaan per menit) per metode API per project. Artinya, setiap metode API memiliki kuota terpisah.
Places API: Batas kapasitas adalah 6.000 QPM (permintaan per menit). Jumlah ini dihitung sebagai jumlah permintaan sisi klien dan sisi server untuk semua aplikasi yang menggunakan kredensial project yang sama.
Pembatasan berdasarkan Persyaratan Penggunaan
Untuk mengetahui informasi tentang persyaratan penggunaan, lihat kebijakan untuk Places API, dan bagian Pembatasan Lisensi dalam Persyaratan Layanan Google Maps Platform.
Mengelola biaya penggunaan
Untuk mengelola biaya penggunaan Places API atau memenuhi permintaan traffic produksi, tetapkan batas kuota harian pada semua permintaan ke API. Kuota harian direset pada tengah malam waktu Pasifik.
Untuk melihat atau mengubah batas kuota Places API:
- Di Konsol Cloud, buka halaman Quotas Google Maps Platform.
- Klik drop-down API dan pilih Places API.
- Untuk melihat batas kuota, scroll ke bawah ke kartu
Requests.
Tabel mencantumkan nama dan batas kuota. - Untuk mengubah batas kuota, klik ikon Edit untuk batas tersebut.
Pada dialog yang muncul, di kolom Quota Limit, masukkan batas kuota harian yang dapat ditagih (hingga batas kuota maksimum yang ditentukan oleh Google jika ada) dan klik Save.
Jika penggunaan API mencapai batas kuota yang dapat ditagih pada hari yang ditentukan, aplikasi Anda tidak akan dapat mengakses API untuk sisa hari tersebut.