Place Details

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Places SDK for Android menyediakan informasi lengkap tentang tempat untuk aplikasi Anda, termasuk nama dan alamat tempat, lokasi geografis yang ditentukan sebagai koordinat lintang/bujur, jenis tempat (seperti klub malam, toko hewan peliharaan, museum), dan lainnya. Untuk mengakses informasi ini untuk tempat tertentu, Anda dapat menggunakan ID tempat, ID stabil yang secara unik mengidentifikasi tempat.

Detail tempat

Objek Place memberikan informasi tentang tempat tertentu. Anda bisa mendapatkan objek Place dengan memanggil PlacesClient.fetchPlace() – Lihat panduan untuk mendapatkan tempat menurut ID.

Saat meminta tempat, Anda harus menentukan data tempat yang akan ditampilkan. Untuk melakukannya, teruskan daftar nilai Place.Field yang menentukan data yang akan ditampilkan. Daftar ini merupakan pertimbangan penting karena memengaruhi biaya untuk setiap permintaan.

Karena hasil data tempat tidak boleh kosong, hanya hasil tempat dengan data yang dikembalikan. Misalnya, jika tempat yang diminta tidak memiliki foto, kolom photos tidak akan ada dalam hasil.

Contoh berikut meneruskan daftar tiga nilai Place.Field untuk menentukan data yang ditampilkan oleh permintaan:

Kotlin

// Specify the fields to return.
val placeFields = listOf(Place.Field.DISPLAY_NAME, Place.Field.RATING)

Java

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.DISPLAY_NAME, Place.Field.RATING);
  

Mengakses kolom data objek Place

Setelah mendapatkan objek Place, gunakan metode objek untuk mengakses kolom data yang ditentukan dalam permintaan. Jika kolom tidak ada dalam objek Place, metode terkait akan menampilkan null. Di bawah ini adalah contoh beberapa metode yang tersedia.

Untuk mengetahui daftar lengkap semua metode, lihat Place referensi API.

• getAddress() – Alamat tempat, dalam format yang dapat dibaca manusia.
• getAddressComponents() – List komponen alamat untuk tempat ini. Komponen ini disediakan untuk tujuan mengekstrak informasi terstruktur tentang alamat suatu tempat, misalnya menemukan kota tempat suatu tempat berada. Jangan gunakan komponen ini untuk pemformatan alamat; sebagai gantinya, panggil getAddress(), yang menyediakan alamat berformat yang dilokalkan.
• getId() – ID tekstual untuk tempat. Baca selengkapnya tentang ID tempat di bagian lain halaman ini.
• getLatLng() – Lokasi geografis tempat, yang ditetapkan sebagai koordinat lintang dan bujur.
• getName() – Nama tempat.

• getOpeningHours() – OpeningHours tempat. Panggil OpeningHours.getWeekdayText() untuk menampilkan daftar string yang merepresentasikan jam buka dan tutup untuk setiap hari dalam seminggu. Panggil OpeningHours.getPeriods() untuk menampilkan daftar objek period dengan informasi yang lebih mendetail yang setara dengan data yang diberikan oleh getWeekdayText().

  Catatan: Jika tempat selalu buka, jangka waktu akan ditampilkan sebagai Minggu tengah malam, dan closeEvent adalah null.

  Objek Place juga berisi metode getCurrentOpeningHours() yang menampilkan jam buka suatu tempat selama tujuh hari ke depan, dan getSecondaryOpeningHours() yang menampilkan jam buka sekunder suatu tempat selama tujuh hari ke depan.

• isOpen() – Boolean yang menunjukkan apakah tempat saat ini buka. Jika tidak ada waktu yang ditentukan, setelan default-nya adalah sekarang. isOpen hanya akan ditampilkan jika Place.Field.UTC_OFFSET dan Place.Field.OPENING_HOURS tersedia. Untuk memastikan hasil yang akurat, minta kolom Place.Field.BUSINESS_STATUS dan Place.Field.UTC_OFFSET dalam permintaan tempat asal Anda. Jika tidak diminta, diasumsikan bahwa bisnis beroperasi. Tonton video ini untuk mengetahui cara menggunakan isOpen dengan Place Details.

  Catatan: Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan PlacesClient.isOpen(IsOpenRequest request). Untuk mengetahui informasi selengkapnya, lihat Mendapatkan status buka.

Beberapa contohnya:

Kotlin

val name = place.name
val address = place.address
val location = place.latLng

      

Java

final CharSequence name = place.getName();
final CharSequence address = place.getAddress();
final LatLng location = place.getLatLng();

      

Mendapatkan tempat melalui ID

ID tempat adalah ID tekstual yang secara unik mengidentifikasi tempat. Di Places SDK for Android, Anda dapat mengambil ID tempat dengan memanggil Place.getId(). Layanan Place Autocomplete juga menampilkan ID tempat untuk setiap tempat yang cocok dengan kueri penelusuran dan filter yang diberikan. Anda dapat menyimpan ID tempat dan menggunakannya untuk mengambil objek Place lagi nanti.

Untuk mendapatkan tempat berdasarkan ID, panggil PlacesClient.fetchPlace(), dengan meneruskan FetchPlaceRequest.

API menampilkan FetchPlaceResponse dalam Task. FetchPlaceResponse berisi objek Place yang cocok dengan ID tempat yang diberikan.

Contoh kode berikut menunjukkan pemanggilan fetchPlace() untuk mendapatkan detail tempat yang ditentukan.

Kotlin

// Define a Place ID.
val placeId = "INSERT_PLACE_ID_HERE"

// Specify the fields to return.
val placeFields = listOf(Place.Field.ID, Place.Field.NAME)

// Construct a request object, passing the place ID and fields array.
val request = FetchPlaceRequest.newInstance(placeId, placeFields)

placesClient.fetchPlace(request)
    .addOnSuccessListener { response: FetchPlaceResponse ->
        val place = response.place
        Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}")
    }.addOnFailureListener { exception: Exception ->
        if (exception is ApiException) {
            Log.e(TAG, "Place not found: ${exception.message}")
            val statusCode = exception.statusCode
            TODO("Handle error with given status code")
        }
    }

      

Java

// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        final ApiException apiException = (ApiException) exception;
        Log.e(TAG, "Place not found: " + exception.getMessage());
        final int statusCode = apiException.getStatusCode();
        // TODO: Handle error with given status code.
    }
});

      

Catatan: Untuk mengetahui informasi selengkapnya tentang cara menginisialisasi PlacesClient, lihat Menginisialisasi klien Places API.

Anda dapat menggunakan CancellationToken untuk mencoba membatalkan permintaan ke salah satu kelas permintaan (misalnya, FetchPlaceRequest). Pembatalan dilakukan dengan upaya terbaik. Setelah permintaan pembatalan dikeluarkan, tidak ada respons yang akan ditampilkan. Penerbitan token pembatalan TIDAK menjamin bahwa permintaan tertentu akan dibatalkan, dan Anda mungkin masih ditagih untuk permintaan tersebut meskipun tidak ada respons yang ditampilkan.

Mendapatkan status buka

Metode PlacesClient.isOpen(IsOpenRequest request) menampilkan objek IsOpenResponse yang menunjukkan apakah tempat tersebut sedang buka berdasarkan waktu yang ditentukan dalam panggilan.

Metode ini mengambil satu argumen jenis IsOpenRequest yang berisi:

• Objek Place atau string yang menentukan ID tempat.
  Catatan: Objek Place harus berisi ID tempat yang valid.
• Nilai waktu opsional yang menentukan waktu dalam milidetik dari 1970-01-01T00:00:00Z. Jika tidak ada waktu yang ditentukan, setelan default-nya adalah sekarang.

Metode ini mengharuskan kolom berikut ada di objek Place:

• Place.Field.BUSINESS_STATUS
• Place.Field.CURRENT_OPENING_HOURS
• Place.Field.OPENING_HOURS
• Place.Field.UTC_OFFSET

Jika kolom ini tidak disediakan dalam objek Place, atau jika Anda meneruskan ID tempat, metode ini akan menggunakan PlacesClient.fetchPlace() untuk mengambilnya. Untuk mengetahui informasi selengkapnya tentang cara membuat objek Place dengan kolom yang diperlukan, lihat Detail tempat.

Catatan: SKU Basic Data Places dikenai biaya untuk panggilan ke fetchPlace() untuk Place.Field.UTC_OFFSET dan Place.Field.BUSINESS_STATUS. SKU Data Kontak Places dikenai biaya untuk panggilan ke fetchPlace() untuk Place.Field.CURRENT_OPENING_HOURS dan Place.Field.OPENING_HOURS.

Contoh berikut menentukan apakah tempat saat ini buka. Dalam contoh ini, Anda hanya meneruskan ID tempat ke isOpen():

Kotlin

val isOpenCalendar: Calendar = Calendar.getInstance()
val placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk"

val request: IsOpenRequest = try {
    IsOpenRequest.newInstance(placeId, isOpenCalendar.timeInMillis)
} catch (e: IllegalArgumentException) {
    e.printStackTrace()
    return
}
val isOpenTask: Task<IsOpenResponse> = placesClient.isOpen(request)
isOpenTask.addOnSuccessListener { response ->
    val isOpen = response.isOpen
}
// ...

      

Java

@NonNull
Calendar isOpenCalendar = Calendar.getInstance();
String placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk";
IsOpenRequest isOpenRequest;

try {
    isOpenRequest = IsOpenRequest.newInstance(placeId, isOpenCalendar.getTimeInMillis());
} catch (IllegalArgumentException e) {
    e.printStackTrace();
    return;
}

Task<IsOpenResponse> placeTask = placesClient.isOpen(isOpenRequest);

placeTask.addOnSuccessListener(
        (response) ->
                isOpen = response.isOpen());
// ...

      

Contoh berikutnya menunjukkan pemanggilan isOpen() tempat Anda meneruskan objek Place. Objek Place harus berisi ID tempat yang valid:

Kotlin

val isOpenCalendar: Calendar = Calendar.getInstance()
var place: Place
val placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk"
// Specify the required fields for an isOpen request.
val placeFields: List<Place.Field> = listOf(
    Place.Field.BUSINESS_STATUS,
    Place.Field.CURRENT_OPENING_HOURS,
    Place.Field.ID,
    Place.Field.OPENING_HOURS,
    Place.Field.UTC_OFFSET
)

val placeRequest: FetchPlaceRequest =
    FetchPlaceRequest.newInstance(placeId, placeFields)
val placeTask: Task<FetchPlaceResponse> = placesClient.fetchPlace(placeRequest)
placeTask.addOnSuccessListener { placeResponse ->
    place = placeResponse.place

    val isOpenRequest: IsOpenRequest = try {
        IsOpenRequest.newInstance(place, isOpenCalendar.timeInMillis)
    } catch (e: IllegalArgumentException) {
        e.printStackTrace()
        return@addOnSuccessListener
    }
    val isOpenTask: Task<IsOpenResponse> = placesClient.isOpen(isOpenRequest)
    isOpenTask.addOnSuccessListener { isOpenResponse ->
        val isOpen = isOpenResponse.isOpen
    }
    // ...
}
// ...

      

Java

@NonNull
Calendar isOpenCalendar = Calendar.getInstance();
String placeId = "ChIJD3uTd9hx5kcR1IQvGfr8dbk";
// Specify the required fields for an isOpen request.
List<Place.Field> placeFields = new ArrayList<>(Arrays.asList(
        Place.Field.BUSINESS_STATUS,
        Place.Field.CURRENT_OPENING_HOURS,
        Place.Field.ID,
        Place.Field.OPENING_HOURS,
        Place.Field.UTC_OFFSET
));

FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

placeTask.addOnSuccessListener(
        (placeResponse) -> {
            Place place = placeResponse.getPlace();
            IsOpenRequest isOpenRequest;

            try {
                isOpenRequest = IsOpenRequest.newInstance(place, isOpenCalendar.getTimeInMillis());
            } catch (IllegalArgumentException e) {
                e.printStackTrace();
                return;
            }
            Task<IsOpenResponse> isOpenTask = placesClient.isOpen(isOpenRequest);

            isOpenTask.addOnSuccessListener(
                    (isOpenResponse) -> isOpen = isOpenResponse.isOpen());
            // ...
        });
// ...

      

Menampilkan atribusi dalam aplikasi Anda

Saat aplikasi Anda menampilkan informasi tempat, termasuk ulasan tempat, aplikasi juga harus menampilkan atribusi apa pun. Untuk mengetahui informasi selengkapnya, lihat atribusi.

Selengkapnya tentang ID tempat

ID tempat yang digunakan di Places SDK for Android adalah ID yang sama dengan yang digunakan di Places API. Setiap ID tempat hanya dapat merujuk ke satu tempat, tetapi satu tempat dapat memiliki lebih dari satu ID tempat. Ada keadaan lain yang dapat menyebabkan tempat mendapatkan ID tempat baru. Misalnya, hal ini dapat terjadi jika bisnis pindah ke lokasi baru.

Saat meminta tempat dengan menentukan ID tempat, Anda dapat yakin bahwa Anda akan selalu menerima tempat yang sama dalam respons (jika tempat tersebut masih ada). Namun, perhatikan bahwa respons dapat berisi ID tempat yang berbeda dengan yang ada dalam permintaan Anda.

Untuk informasi selengkapnya, lihat ringkasan ID tempat.