Garis batas dan pintu masuk bangunan

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 di building_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 objek display_polygon dapat merepresentasikan beberapa poligon.

Cakupan

Fitur ini tersedia di semua wilayah; namun, tidak semua bangunan akan memiliki garis batas atau jalur masuk.

Masukan

Ini adalah fitur eksperimental. Kami akan sangat menghargai masukan buildings-in-geocoding-feedback-channel@google.com.