Garis batas bangunan adalah satu rangkaian pasangan koordinat garis lintang/garis bujur yang mendefinisikan Poligon 2D yang mewakili luas permukaan bumi yang ditutupi bangunan. Anda dapat menggunakan poligon ini untuk menggambar garis luar bangunan pada peta. Titik masuk adalah pasangan koordinat lintang/bujur tunggal yang menentukan lokasi titik masuk dan keluar ke suatu tempat; misalnya, pintu saat ini.
Parameter tambahan
Sertakan
extra_computations=BUILDING_AND_ENTRANCES
dalam permintaan geocoding,
permintaan geocoding terbalik,
atau permintaan geocoding tempat
untuk menerima pintu masuk dan membangun garis besarnya dalam tanggapan Anda.
Contoh permintaan
Kueri berikut memungkinkan Anda membangun garis besar dan pintu masuk untuk sebuah restoran di Mountain View, California, Amerika Serikat:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY
Contoh respons
Respons dari kueri di atas adalah sebagai berikut:
{
"entrances": [
{
"location": {
"lat": 37.3925065,
"lng": -122.0799465
},
"building_place_id": "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
"buildings" : [
{
"building_outlines" : [
{
"display_polygon" : {
"coordinates" : [
[
[
-122.080188246116,
37.3926407183216
],
[
-122.080281351765,
37.3924887558601
],
[
-122.080023707261,
37.392390122414
],
[
-122.079926266852,
37.3925369491992
],
[
-122.080188246116,
37.3926407183216
]
]
],
"type" : "Polygon"
}
}
],
"place_id" : "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
}
Ada 2 array yang dapat ditampilkan saat fitur ini diaktifkan:
buildings[]
dan entrances[]
.
Setiap hasil entrances
memiliki kolom berikut:
location
adalah koordinat lintang/bujur pintu masuk.building_place_id
adalah ID tempat bangunan yang berisi pintu masuk. Perhatikan bahwa parameter ini tidak akan selalu diisi.
Setiap hasil buildings
memiliki kolom berikut:
place_id
adalah ID unik gedung. Lihat ringkasan ID tempat untuk mengetahui detail selengkapnya.building_outlines[]
adalah array garis batas yang terkait dengan di dalam gedung. Untuk sekarang, array ini hanya akan memiliki satu entri. Setiap objek dibuilding_outlines[]
memiliki kolom berikut:display_polygon
adalah encoding GeoJSON untuk poligon yang mendekati luas permukaan bumi yang tertutup oleh bangunan, menggunakan Format RFC 7946. Perhatikan bahwa format RFC 7946 mendukung multi-poligon, sehingga satu objekdisplay_polygon
dapat merepresentasikan beberapa poligon.
Cakupan
Fitur ini tersedia di semua wilayah; namun, tidak semua bangunan akan memiliki garis besar atau jalur masuk, dan cakupan akan bervariasi menurut wilayah. Selain itu, Anda harus mengelompokkan mengharapkan untuk menerima respons API yang berisi garis batas bangunan tetapi tidak metrik masuk. Cakupan masuk diperkirakan akan meningkat seiring waktu.
Masukan
Ini adalah fitur eksperimental. Kami akan sangat menghargai masukan buildings-in-geocoding-feedback-channel@google.com.