Penggunaan dan Penagihan Places API

Places API (Baru) dan Places API menggunakan model harga bayar sesuai penggunaan. Permintaan Places API (Baru) dan Places API menghasilkan panggilan ke salah satu dari beberapa SKU. Selain Persyaratan Penggunaan Google secara keseluruhan, ada batas penggunaan khusus untuk Places API. Kelola biaya dan penggunaan Anda dengan alat yang tersedia di Konsol Google Cloud.

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:

Penggunaan SKU × Harga per penggunaan

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 akan 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 Address Validation. 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 Address Validation kemudian dibuat saat pengguna telah memilih salah satu saran Autocomplete (Baru). Jika sesi ditinggalkan, yang berarti tidak ada permintaan Place Details (Baru) atau permintaan Address Validation yang dibuat, permintaan Autocomplete (Baru) akan dikenai biaya seolah-olah tidak ada token sesi yang diberikan.

Setelah pengguna memilih tempat (artinya permintaan Place Details (New) atau permintaan Address Validation 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: Autocomplete Requests

SKU Autocomplete Requests dikenai biaya untuk setiap permintaan ke Autocomplete (New) API yang tidak menyertakan token sesi.

Anda juga akan dikenai biaya jika menggunakan token sesi dan:

  • Akhiri sesi dengan satu permintaan ke Place Details (New) yang meminta kolom apa pun yang ditentukan oleh SKU: Place Details (Location Only).
    • Setiap permintaan Autocomplete (Baru), hingga 12 permintaan, ditagih menggunakan SKU: Autocomplete Requests.
    • Setiap permintaan Autocomplete (Baru) berikutnya ditagih menggunakan SKU: Autocomplete Session Usage.
  • Batalkan 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)
0—100.000 100.001—500.000 500.000+
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 pelengkapan otomatis dihentikan oleh panggilan ke SKU: Place Details (Location Only):

    • Setiap permintaan Autocomplete (Baru), hingga 12 permintaan, ditagih menggunakan SKU: Autocomplete Requests.
    • Setiap permintaan Autocomplete (Baru) berikutnya 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) ditagih dengan tarif SKU: Place Details (Preferred).

  • Sesi Autocomplete dihentikan dengan panggilan ke SKU: Address Validation Preferred.

Untuk mengetahui informasi selengkapnya, lihat Harga Autocomplete (Baru) dan sesi.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
USD0,00 per 1 permintaan
(USD0,00 per 1.000)		 USD0,00 per 1 panggilan
(USD0,00 per 1.000)		 USD0,00 per 1 permintaan
(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 dipicu jika Anda hanya meminta kolom berikut:

Layanan web: attributions, id, name*, photos

* Kolom name berisi nama resource tempat dalam format: places/PLACE_ID. Gunakan displayName untuk mengakses nama tekstual tempat tersebut.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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 (Location 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: addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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, containingPlaces, displayName, googleMapsLinks*, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, pureServiceAreaBusiness, subDestinations, utcOffsetMinutes

* Kolom googleMapsLinks berada dalam tahap pra-GA, yang berarti tidak dikenai biaya untuk pratinjau $0,

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 informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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, priceRange, 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 informasi selengkapnya, lihat SKU: Penggunaan Sesi Autocomplete.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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, outdoorSeating, reservable, restroom, reviews, routingSummaries,* servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

* Khusus Penelusuran Teks dan Penelusuran di Sekitar

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.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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 (New), 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.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name**, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport

* Kolom places.googleMapsLinks berada dalam tahap Pratinjau pre-GA dan tidak ada biaya, yang berarti penagihan adalah $0, untuk penggunaan selama Pratinjau.

** 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)
0—100.000 100.001—500.000 500.000+
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 (New), 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.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* Khusus Penelusuran Teks dan Penelusuran di Sekitar

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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 format: places/PLACE_ID. Gunakan places.displayName untuk mengakses nama tekstual tempat tersebut.

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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 di permintaan Text Search (New), Anda dapat membatasi respons hanya untuk kolom yang ditentukan. SKU ini terpicu jika Anda hanya meminta kolom berikut:

places.accessibilityOptionsplaces.addressComponentsplaces.adrFormatAddressplaces.businessStatusplaces.containingPlacesplaces.displayNameplaces.formattedAddressplaces.googleMapsLinksplaces.googleMapsLinksplaces.googleMapsUriplaces.iconBackgroundColorplaces.iconMaskBaseUriplaces.locationplaces.photosplaces.plusCodeplaces.primaryTypeplaces.primaryTypeDisplayNameplaces.pureServiceAreaBusinessplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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 di permintaan Text Search (New), 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.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout

* Khusus Penelusuran Teks dan Penelusuran di Sekitar

RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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)
0—100.000 100.001—500.000 500.000+
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:

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, 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.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, atau Place.Field.UTC_OFFSET.
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinessStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes, atau 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, atau wheelchair_accessible_entrance
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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.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
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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, atau Place.Field.USER_RATING_COUNT
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch, atau GMSPlaceFieldServesVegetarianFood.
  • 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, atau user_ratings_total.
RENTANG VOLUME BULANAN
(Harga per PANGGILAN)
0—100.000 100.001—500.000 500.000+
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:

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)
0—100.000 100.001—500.000 500.000+
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)
0—100.000 100.001—500.000 500.000+
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

iOS

Layanan web

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 hal berikut:

  • 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)
0—100.000 100.001—500.000 500.000+
USD0,00 USD0,00 USD0,00

Contoh

Jika aplikasi Anda melakukan tiga panggilan berikut dalam satu sesi:

Android

iOS

Layanan web

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:

RENTANG VOLUME BULANAN
(Harga per PERMINTAAN)
0—100.000 100.001—500.000 500.000+
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)
0—100.000 100.001—500.000 500.000+
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:

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 TIDAK ADA kolom yang ditentukan dalam panggilan atau permintaan Place Details, SEMUA SKU Data akan terpicu, dan Anda akan dikenai biaya untuk panggilan atau permintaan Place Details ditambah biaya semua data.

Contoh

  1. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan hanya menentukan 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 (harga mulai dari USD0,017 per sesi)
    • Basic Data (dikenai biaya USD0,00)
  2. Lakukan salah satu panggilan atau permintaan berikut:
    • Seluler: memanggil fetchPlace() di Android atau fetchPlaceFromPlaceID: di iOS, dan hanya menentukan kolom PHONE_NUMBER
    • API atau layanan web: mengirimkan permintaan Place Details dan menentukan hanya kolom nomor telepon: getPlaceDetails(fields: formatted_phone_number)
    Dalam tagihan, Anda akan melihat SKU berikut tercantum (saat melihat tagihan berdasarkan SKU):
    • Place Details (harga mulai dari USD0,017 per sesi)
    • Contact Data (harga mulai dari USD0,003 per permintaan)
  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 (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)

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)
0—100.000 100.001—500.000 500.000+
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)
0—100.000 100.001—500.000 500.000+
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 TIDAK ADA kolom yang diminta, hanya ID tempat yang akan ditampilkan, sehingga tidak menimbulkan biaya data tambahan.

Contoh

  1. 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)
  2. 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)
  3. 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)
0—100.000 100.001—500.000 500.000+
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)

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)
0—100.000 100.001—500.000 500.000+
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)
0—100.000 100.001—500.000 500.000+
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
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

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:

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)
0—100.000 100.001—500.000 500.000+
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:

  1. Di Konsol Cloud, buka halaman Quotas Google Maps Platform.
  2. Klik drop-down API dan pilih Places API.
  3. Untuk melihat batas kuota, scroll ke bawah ke kartu Requests.
    Tabel mencantumkan nama dan batas kuota.
  4. 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.