Penggunaan dan Penagihan Maps JavaScript API

Permintaan Maps JavaScript API menghasilkan panggilan ke dua SKU yang berbeda, bergantung pada jenis permintaan: pemuatan peta atau panorama. Panggilan ke Library Places, Maps JavaScript API dan layanan JavaScript lainnya diberi harga secara terpisah dari SKU native JavaScript. Klik ikon info info untuk melihat daftar isi halaman ini.

Penagihan dan harga untuk Maps JavaScript API

Untuk mengetahui informasi tentang cara Google menghitung penagihan dan harga, lihat daftar harga Google Maps Platform atau daftar harga Google Maps Platform - India.

SKU: Dynamic Maps

SKU ini menagih pemuatan peta saat aplikasi menampilkan peta.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Pemuatan peta
  Triggers

SKU ini menagih pemuatan peta saat aplikasi menampilkan peta yang dimuat dengan salah satu cara berikut:

Interaksi pengguna dengan peta, misalnya menggeser, melakukan zoom, atau mengganti lapisan peta, tidak menghasilkan pemuatan peta tambahan.

  Harga Tabel harga utama
Tabel harga India

SKU: Dynamic Street View

SKU ini menagih permintaan ke Street View Static API yang menampilkan panorama street view dinamis.

  Kategori Pro
  Peristiwa yang dapat ditagih Panorama
  Triggers

SKU ini dipicu saat Anda membuat instance objek panorama menggunakan salah satu class atau metode berikut:

  Harga Tabel harga utama
Tabel harga India

Harga untuk Places Library, Maps JavaScript API

SKU: Autocomplete Requests

SKU ini menagih permintaan ke Autocomplete API yang tidak menggunakan sesi. Untuk informasi tentang penggunaan sesi guna membatasi jumlah permintaan yang ditagih selama satu sesi Autocomplete, lihat Token sesi atau SKU: Penggunaan Sesi Autocomplete.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu dalam kondisi berikut:

  • Permintaan Anda tidak menyertakan token sesi.
  • Permintaan Anda menyertakan token sesi, tetapi Anda meninggalkan sesi.
  • Permintaan Anda menyertakan token sesi, tetapi Anda menghentikan sesi dalam kondisi tertentu. Untuk informasi tentang Penggunaan Sesi Autocomplete, lihat Token sesi atau Penggunaan Sesi Autocomplete.
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete Session Usage

SKU ini menagih setiap permintaan ke Autocomplete (New) API yang menyertakan token sesi.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda mengirim permintaan ke Autocomplete (New) API yang menyertakan token sesi.

SKU ini berfungsi sebagai wrapper untuk SKU permintaan Autocomplete (Baru) yang memberikan cara bagi Anda untuk membatasi jumlah permintaan yang ditagih selama satu sesi Autocomplete. Untuk mengetahui informasi tentang Penggunaan Sesi Autocomplete, lihat Token sesi.

Catatan: Jika tidak menggunakan sesi dengan Autocomplete (Baru), Anda akan ditagih per permintaan ke Autocomplete menggunakan SKU: Autocomplete Requests.

  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Essentials (IDs Only)

SKU ini menagih permintaan ke Place Details yang hanya menampilkan ID Tempat.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

  • Places Library, Maps JavaScript API:
    id
    photos

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Essentials

SKU ini menagih permintaan ke Place Details API yang mengambil kolom dalam SKU ini.
  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu saat Anda meminta kolom lokasi berikut:

  • Places Library, Maps JavaScript API:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    types
    viewport

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Pro

SKU ini menagih kolom yang Anda tentukan dalam permintaan Place Details Pro.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom tarif yang lebih rendah:
  • Places Library, Maps JavaScript API:
    accessibilityOptions
    businessStatus
    displayName
    googleMapsUri
    iconBackgroundColor
    primaryTypeDisplayName
    svgIconMaskURI
    types
    utcOffsetMinutes

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Enterprise

SKU ini menagih permintaan Places yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:
  • Places Library, Maps JavaScript API: internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

Jika Anda menghentikan sesi Autocomplete dengan panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred), panggilan tersebut akan ditagih dengan SKU: Place Details (Preferred). Untuk informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Enterprise + Atmosphere

SKU ini menagih panggilan ke Place Details API yang meminta kolom atmosfer yang ditentukan.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

  • Places Library, Maps JavaScript API:
    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

Jika sesi Autocomplete dihentikan oleh panggilan Place Details yang meminta kolom apa pun dari SKU: Place Details (Basic, Advanced, atau Preferred), panggilan tersebut akan ditagih dengan SKU: Place Details (Preferred). Untuk informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Pro

SKU ini menagih kolom yang Anda tentukan dalam permintaan Nearby Search Pro.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom tarif yang lebih rendah:
  • Places Library, Maps JavaScript API:
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    id
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Enterprise

SKU ini menagih permintaan Penelusuran Langsung yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Pemicu

SKU ini dipicu saat Anda meminta kolom berikut:

  • Places Library, Maps JavaScript API:
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Nearby Search Enterprise + Atmosphere

SKU ini menagih permintaan penelusuran terdekat yang menyertakan kolom atmosfer yang ditentukan.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda meminta kolom berikut:

  • Places Library, Maps JavaScript API:
    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

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Essentials (IDs Only)

SKU ini ditagih untuk permintaan ke Text Search API yang hanya menampilkan ID.
  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers

SKU ini dipicu jika Anda hanya meminta kolom berikut:

  • Places Library, Maps JavaScript API:
    id

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Pro

SKU ini adalah SKU Data yang menagih kolom yang Anda tentukan dalam permintaan Text Search Pro.
  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu jika Anda hanya meminta kolom berikut atau kolom dengan tarif lebih rendah:
  • Places Library, Maps JavaScript API:
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Enterprise

SKU ini menagih permintaan Text Search yang menyertakan kolom Enterprise.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:
  • Places Library, Maps JavaScript API:
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Text Search Enterprise + Atmosphere

SKU ini menagih permintaan Text Search yang menyertakan kolom atmosfer.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini dipicu saat Anda meminta kolom berikut:
  • Places Library, Maps JavaScript API:
    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

  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Place Details Photos

SKU ini menagih permintaan Place Details Photos.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu saat Anda meminta foto dari Place Details API.
  Harga Tabel harga utama
Tabel harga India

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, setelah panggilan Places Details dilakukan), Anda harus memulai sesi baru menggunakan token sesi baru.

Sesi Autocomplete dapat dibuat dari API berikut:

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() atau findCurrentPlace()
  • iOS: setiap panggilan ke fetchPlaceFromPlaceID: atau findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • 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, permintaan Places API berikut memungkinkan Anda menentukan kolom data yang akan 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

SKU ini adalah SKU Data yang menagih kolom Basic Data dalam permintaan Place Details atau Find Place. SKU ini dikenai biaya selain SKU dasar untuk permintaan yang memicunya.

Kolom pada kategori Basic tercakup dalam biaya dasar permintaan Places dan tidak akan dikenai biaya tambahan.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU Basic Data terpicu saat Anda meminta salah satu kolom berikut:
  • 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
  • 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
    wheelchair_accessible_entrance
  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Contact Data

SKU ini adalah SKU Data yang menagih kolom Contact Data dalam permintaan Place Details atau Find Place. SKU ini dikenai biaya selain SKU dasar untuk permintaan yang memicunya.

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.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers SKU Contact Data terpicu jika ada permintaan untuk kolom berikut:
  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, atau Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber, atau GMSPlaceFieldWebsite
  • Layanan web: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours, atau website
  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Atmosphere Data

SKU ini menagih permintaan ke Atmosphere Data API yang menentukan kolom dalam SKU ini.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan dengan mask kolom yang ditentukan.
  Triggers Penagihan dipicu saat Anda meminta salah satu 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
Place.Field.USER_RATING_COUNT

iOS

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

JavaScript

Lihat Kolom (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.
  Contoh penagihan mask kolom

Berikut adalah contoh cara penagihan permintaan berdasarkan kolom yang Anda pilih di mask kolom.

  • Jika mask kolom permintaan Anda hanya menyertakan kolom dari SKU ini: Permintaan ditagih dengan tarif SKU ini. Misalnya, Anda dapat meminta satu atau beberapa kolom dari SKU ini, dan ditagih dengan tarif SKU ini.
  • Jika mask kolom permintaan Anda menyertakan kolom dari SKU lain: Permintaan ditagih dengan tarif SKU tertinggi untuk kolom yang diminta. Misalnya, jika Anda menyertakan kolom dari beberapa SKU, seperti SKU Essentials dan SKU Enterprise, permintaan akan ditagih dengan tarif SKU Enterprise.
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete – Per Request

SKU ini menagih permintaan yang tidak menyertakan token sesi

Jika Anda membuat permintaan dari sesi Autocomplete yang tidak valid (misalnya, sesi yang menggunakan ulang token sesi), Anda juga akan dikenai biaya untuk SKU Autocomplete – Per Request.

Permintaan Autocomplete dari Widget Place Autocomplete Maps JavaScript API mungkin dikenai biaya SKU Autocomplete – Per Request saat Anda membuat permintaan dari sesi Autocomplete yang tidak valid. Situasi ini dapat terjadi saat pengguna mengetik atau menyalin/menempel beberapa alamat yang berbeda ke widget dan tidak selalu memilih prediksi pelengkapan otomatis.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk:
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete without Place Details – Per Session

SKU ini ditagih saat untuk sesi Autocomplete yang tidak menyertakan permintaan Place Details (dalam waktu beberapa menit pada awal sesi).

  Kategori Pro
  Peristiwa yang dapat ditagih Sesi
  Triggers Penagihan dipicu jika aplikasi Anda mengeluarkan dua permintaan berikut dalam satu sesi:

Saat melihat tagihan berdasarkan SKU, Anda akan melihat SKU berikut tercantum:

  • Autocomplete without Place Details – Per Session
  Harga Tabel harga utama
Tabel harga India

SKU: Autocomplete (included with Place Details) – Per Session

Permintaan untuk pelengkapan otomatis tersedia tanpa biaya. SKU ini ditagih saat Anda meminta Place Details berikutnya berdasarkan harga Place Details reguler.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Sesi
  Triggers SKU Autocomplete (included with Place Details) – Per Session dikenai biaya untuk sesi Autocomplete yang menyertakan salah satu permintaan berikut:
  • Android: panggilan ke fetchPlace()
  • iOS: panggilan ke fetchPlaceFromPlaceID:
  • Layanan web: permintaan Place Details

Permintaan Place Details menghasilkan SKU Data (Basic, Contact, dan/atau Atmosphere) – bergantung pada kolom yang Anda tentukan dalam permintaan.

Jika Anda tidak meminta kolom tertentu dalam permintaan Place Details, semua SKU Data akan terpicu (Essentials, Pro, Enterprise, dan Enterprise + Atmosphere). Tentukan hanya kolom yang Anda perlukan untuk menghindari tagihan yang tidak perlu.

Jika Anda hanya meminta pembaruan ID Place Details (permintaan Anda hanya menentukan kolom place_id) selama sesi pelengkapan otomatis, sesi tersebut akan ditagih sebagai SKU: Autocomplete without Place Details – Per Session.

  Contoh

Jika aplikasi Anda melakukan tiga panggilan berikut dalam satu sesi:

Layanan web

Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data
  Harga Tabel harga utama
Tabel harga India

SKU: Query Autocomplete – Per Request

SKU lama ini menagih untuk permintaan Query Autocomplete.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers

SKU ini dipicu saat Anda membuat permintaan Autocomplete Kueri menggunakan layanan berikut:

Harga menurut sesi Autocomplete tidak didukung menggunakan Query Autocomplete. Permintaan Place Details selanjutnya akan dikenai biaya berdasarkan SKU Place Details Pro.

  Harga Tabel harga utama
Tabel harga India

SKU: Place Details Pro

SKU ini menagih permintaan Place Details lama.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk permintaan dari API berikut:

Dengan API dan layanan web, SKU Place Details akan dikenai biaya, baik Anda memberikan token sesi atau tidak.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.

  Contoh
  1. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: panggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan tentukan hanya kolom ADDRESS
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom alamat: getPlaceDetails(fields: formatted_address)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Basic Data
  2. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: panggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan tentukan hanya kolom PHONE_NUMBER
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan kolom nomor telepon: getPlaceDetails(fields: formatted_phone_number)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Data Kontak
  3. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: 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().
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details
    • Basic Data
    • Data Kontak
    • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Place Details – ID Refresh

SKU ini menagih permintaan ke Place Details API yang memperbarui ID tempat yang lama.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu saat Anda membuat permintaan Place Details dengan menentukan hanya kolom ID tempat: getPlaceDetails(fields: place_id).
  Harga Tabel harga utama
Tabel harga India

SKU: Find Place

SKU ini menagih permintaan ke Find Place yang menampilkan lebih banyak kolom selain ID Tempat.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini menagih permintaan ke metode berikut:
  • Cari Tempat Saat Ini

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.

  Contoh

Contoh berikut menunjukkan SKU yang ditagih saat Anda membuat permintaan Find Current Place dan menentukan kolom dari SKU data Basic, Contact, dan Atmosphere. Untuk melihat SKU di tagihan, lihat tagihan berdasarkan SKU seperti yang dijelaskan dalam Menganalisis penggunaan dan biaya per SKU.

  1. Anda mengirimkan permintaan Find Place dan menentukan hanya kolom alamat: FindPlace(fields: formatted_address). Tagihan Anda menampilkan SKU berikut:
    • Cari Tempat
    • Basic Data
  2. Anda mengirimkan permintaan Find Place dan menentukan kolom nomor telepon: FindPlace(fields: formatted_phone_number). Tagihan Anda menampilkan SKU berikut:
    • Cari Tempat
    • Data Kontak
  3. Anda mengirimkan permintaan Find Place dan menentukan kolom dari ketiga kumpulan jenis data: FindPlace(fields: formatted_address, opening_hours, price_level). Tagihan Anda menampilkan SKU berikut:
    • Cari Tempat
    • Basic Data
    • Data Kontak
    • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Find Place – ID only

SKU ini menagih permintaan ke Find Place yang hanya menampilkan ID Tempat. Secara default, jika Anda tidak menentukan kolom apa pun dalam permintaan Find Place, hanya ID tempat yang akan ditampilkan.

  Kategori Dasar-Dasar
  Peristiwa yang dapat ditagih Permintaan
  Triggers Anda mengirimkan permintaan Find Place tanpa menentukan kolom apa pun, atau Anda hanya menentukan kolom place_id: FindPlace(fields: place_id).
  Harga Tabel harga utama
Tabel harga India

SKU: Places – Nearby Search

SKU ini menagih permintaan Nearby Search.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers SKU ini dipicu saat Anda membuat permintaan Penelusuran Langsung menggunakan salah satu API berikut:

Permintaan ini tidak mendukung penentuan kolom yang akan ditampilkan. Respons akan menampilkan daftar tempat dan subkumpulan kolom data yang didukung.

SKU ini juga memicu penagihan untuk SKU Data: Jika Anda menyertakan kolom data dalam permintaan, hal ini dapat memicu penagihan tambahan untuk SKU Data: Basic, Contact, dan Atmosphere. Tentukan hanya kolom data yang Anda inginkan untuk menghindari biaya yang tidak perlu. Anda akan ditagih untuk SKU ini serta untuk data yang Anda minta.

  Contoh

Anda mengirimkan permintaan Nearby Search, seperti NearbySearch (San Francisco, 100 meters). Tagihan Anda akan menampilkan SKU ini saat melihat tagihan berdasarkan SKU:

  • Tempat
  • Basic Data
  • Data Kontak
  • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Places – Text Search

SKU ini menagih permintaan ke layanan Places Text Search.

  Kategori Pro
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk permintaan ke layanan berikut:

Permintaan Text Search menampilkan daftar tempat, tetapi tidak mendukung penetapan kolom yang ditampilkan. Permintaan Text Search menampilkan subkumpulan kolom data yang didukung. Anda dikenai biaya untuk permintaan Text Search serta semua SKU jenis data: Basic Data, Contact Data, dan Atmosphere Data.

SKU Place – Text Search juga dipicu oleh metode getPlaces() pada widget Place SearchBox Maps JavaScript API setelah pengguna memilih kueri tempat (ikon: kaca pembesar), bukan hasil (ikon: pin), seperti yang digambarkan di sini:

Pilihan Kueri Widget Kotak Penelusuran Places Details
Pada hasil widget kotak penelusuran, setelah mengetik "pizza" di kotak penelusuran, lihat bahwa pizza delivery memiliki ikon kaca pembesar di sampingnya, yang menunjukkan bahwa itu adalah kueri tempat (dan bukan hasil).
  Contoh

Jika Anda membuat permintaan Text Search, seperti TextSearch(123 Main Street), tagihan Anda akan menampilkan SKU berikut saat melihat tagihan berdasarkan SKU:

  • Tempat - Penelusuran Teks
  • Basic Data
  • Data Kontak
  • Data Atmosfer
  Harga Tabel harga utama
Tabel harga India

SKU: Places API Place Details Photos

SKU ini menagih layanan Places Photo lama.

  Kategori Enterprise
  Peristiwa yang dapat ditagih Permintaan
  Triggers Penagihan dipicu untuk:
  Harga Tabel harga utama
Tabel harga India

Harga untuk layanan JavaScript

Layanan JavaScript diberi harga secara terpisah. Lihat halaman penggunaan dan penagihan layanan untuk informasi selengkapnya:

Batas penggunaan lainnya

Meskipun tidak ada jumlah maksimum permintaan per hari, batas penggunaan berikut berlaku untuk Maps JavaScript API:

  • 30.000 QPM (permintaan per menit).
  • 300 QPM (permintaan per menit) per alamat IP. Di konsol Google Cloud, kuota ini disebut sebagai Pemuatan peta per menit per pengguna.

Batas penggunaan Peta 3D Fotorealistik di Maps JavaScript

Batas penggunaan berikut berlaku untuk Peta 3D Fotorealistik di Maps JavaScript

  • 100 QPM (permintaan per menit) .
  • 10 QPM (permintaan per menit) per alamat IP .

Pembatasan berdasarkan Persyaratan Penggunaan

Untuk mengetahui detail selengkapnya tentang penggunaan yang diizinkan, lihat bagian Pembatasan Lisensi di Persyaratan Layanan Google Maps Platform.