ID Tempat

ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps.

  1. Ringkasan
  2. Mengambil detail tempat menggunakan ID tempat
  3. Menangani beberapa ID tempat dan lingkup ID tempat
  4. Menemukan ID tempat tertentu
  5. Menyimpan ID tempat untuk digunakan nanti

Menemukan ID tempat tertentu

Anda mencari ID tempat tertentu? Gunakan pencari ID tempat di bawah ini untuk menelusuri tempat dan mendapatkan ID-nya:

Atau, Anda bisa menampilkan pencari ID tempat beserta kodenya dalam dokumentasi Google Maps JavaScript API.

Ringkasan

ID tempat adalah identifier tekstual yang secara unik mengidentifikasi tempat. Penampilannya mirip dengan contoh berikut (panjang identifier mungkin bervariasi):

ChIJrTLr-GyuEmsRBfy61i59si0

ID tempat tersedia untuk sebagian besar lokasi, termasuk lokasi bisnis, landmark, taman, dan persimpangan. Semua ID ini stabil, maksudnya, sekali Anda mengidentifikasi ID tempat untuk tempat tersebut, Anda bisa menggunakan kembali nilainya bila suatu saat ingin mencari tempat itu lagi.

Anda bisa menggunakan ID tempat yang sama di semua Google Places API dan di beberapa Google Maps API. Misalnya, Anda bisa menggunakan ID tempat yang sama untuk mereferensikan sebuah tempat di Places API, Google Maps JavaScript API, Google Maps Geocoding API, Google Maps Embed API dan Google Maps Roads API.

Mengambil detail tempat menggunakan ID tempat

ID tempat menyediakan cara yang bisa diandalkan dalam mereferensikan informasi untuk tempat tertentu. Cara umum dalam menggunakan ID tempat adalah untuk menelusuri suatu tempat (menggunakan Google Places API Web Service atau Places Library di Google Maps JavaScript API, misalnya) kemudian menggunakan ID tempat yang dikembalikan untuk mengambil detail tempat. Anda juga bisa menyimpan ID tempat dan menggunakannya untuk mengambil detail tempat yang sama nanti.

Contoh penggunaan Places Library di Google Maps JavaScript API

Untuk menggunakan ID tempat dalam aplikasi JavaScript, Anda terlebih dahulu harus menemukan ID, yang tersedia di PlaceResult yang dikembalikan oleh Place Search, atau melalui getPlace() di layanan Place Autocomplete. Kemudian Anda bisa menggunakan ID tempat untuk mencari detail tempat.

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

Menangani beberapa ID tempat dan lingkup ID tempat

Setiap ID tempat bisa merujuk ke satu tempat saja, namun satu tempat bisa memiliki lebih dari satu ID tempat. Kasus yang paling umum untuk menangani multi-ID sebuah tempat adalah bila Anda telah menambahkan tempat yang awalnya dalam cakupan aplikasi Anda, lalu menerima lingkup berskala Google.

Bila menambahkan tempat menggunakan Places API Web Service, Anda akan menerima ID tempat untuk tempat baru itu dengan segera. ID tempat ini hanya sebatas untuk aplikasi Anda saja. Tempat tersebut kemudian masuk antrean moderasi, menunggu persetujuan untuk penambahan ke database Google Places. Jika disetujui, tempat itu akan menerima ID tempat baru, yang bisa digunakan semua aplikasi dan pada Google Maps. Lihat dokumentasi mengenai menambahkan tempat untuk detail selengkapnya.

Ada keadaan lain yang mungkin menyebabkan suatu tempat mendapatkan ID tempat baru. Misalnya, hal ini bisa terjadi jika bisnis pindah ke lokasi baru.

Diagram berikut menampilkan satu kemungkinan skenario di mana sebuah tempat memiliki lebih dari satu ID tempat:

Mengambil tempat yang memiliki beberapa ID

Bila suatu tempat memiliki beberapa ID, hal itu tidak akan memengaruhi permintaan Places API. Akan tetapi, hal ini akan memengaruhi respons.

Bila Anda meminta sebuah tempat dengan menetapkan ID tempat, Anda bisa yakin akan selalu menerima tempat yang sama dalam respons (jika tempat itu masih ada).

Akan tetapi, perlu diketahui bahwa respons itu mungkin berisi lebih dari satu ID tempat untuk tempat yang diminta, atau mungkin berisi ID tempat yang berbeda dari yang Anda minta.

  • Perilaku di Places API Web Service: Jika suatu tempat memiliki beberapa ID, Places API Web Service akan mengembalikan ID utama untuk tempat tersebut, dan larik berisi semua ID alternatif untuk tempat itu. Lihat dokumentasi mengenai detail tempat dan penelusuran tempat.
  • Perilaku dalam Places JavaScript Library dan API lainnya: Bila Anda meminta detail tempat untuk ID tempat tertentu, Anda akan menerima detail untuk tempat yang diminta. Akan tetapi, perlu diperhatikan bahwa ID tempat itu mungkin berbeda, jika tempat tersebut telah menerima ID baru sejak permintaan Anda sebelumnya. Anda tetap aman menggunakan ID tempat asal untuk mengakses tempat tersebut, namun disarankan agar Anda menukarnya menggunakan ID tempat yang paling baru dikembalikan bila memungkinkan.

Menyimpan ID tempat untuk digunakan nanti

ID tempat dikecualikan dari pembatasan caching yang disebutkan di Bagian 10.5.d di Ketentuan Layanan Google Maps API. Karena itu Anda bisa menyimpan nilai ID tempat secara tak terbatas.

Kirim masukan tentang...