Gebäudeumrisse und Eingänge

Ein Gebäudeumriss besteht aus einer Reihe von Koordinatenpaaren für Breiten- und Längengrad, die ein 2D-Polygon definieren, das die vom Gebäude abgedeckte Erdoberfläche darstellt. Mit diesem Polygon können Sie den Umriss eines Gebäudes auf einer Karte zeichnen. Ein Eingang ist ein einzelnes Paar aus Breiten- und Längengradkoordinaten, das den Standort eines Ein- und Ausstiegspunkts an einem Ort definiert, z. B. die Tür eines Gebäudes.

Zusätzliche Parameter

Fügen Sie extra_computations=BUILDING_AND_ENTRANCES in eine Geocoding-Anfrage, eine umgekehrte Geocoding-Anfrage oder eine Geocoding-Anfrage für Orte ein, um Eingänge und Gebäudeumrisse in der Antwort zu erhalten.

Beispielanfrage

Die folgende Abfrage aktiviert Gebäudeumrisse und Eingänge für ein Restaurant in Mountain View, Kalifornien, USA:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY

Beispielantwort

Die Antwort auf die obige Abfrage sieht so aus:

{
  "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"
    }
  ],
}

Wenn dieses Feature aktiviert ist, können zwei Arrays zurückgegeben werden: buildings[] und entrances[].

Jedes entrances-Ergebnis enthält die folgenden Felder:

  • location sind die Breiten- und Längengrade des Eingangs.
  • building_place_id ist die Orts-ID des Gebäudes, in dem sich der Eingang befindet. Dieser Parameter wird nicht immer ausgefüllt.

Jedes buildings-Ergebnis enthält die folgenden Felder:

  • place_id ist die eindeutige Kennung des Gebäudes. Weitere Informationen finden Sie in der Übersicht zur Orts-ID.
  • building_outlines[] ist ein Array von Umrissen, die dem Gebäude zugeordnet sind. Derzeit hat dieses Array nur einen Eintrag. Jedes Objekt in building_outlines[] hat die folgenden Felder:
    • display_polygon ist die GeoJSON-Codierung des Polygons, das die vom Gebäude bedeckte Erdoberfläche annähernd darstellt. Dabei wird das Format RFC 7946 verwendet. Das RFC 7946-Format unterstützt Mehrfachpolygone. Ein display_polygon-Objekt kann also mehrere Polygone darstellen.

Abdeckung

Diese Funktion ist in allen Regionen verfügbar. Allerdings haben nicht alle Gebäude Umrisse oder Eingänge und die Abdeckung variiert je nach Region. Außerdem sollten Sie davon ausgehen, dass Sie API-Antworten erhalten, die einen Gebäudeentwurf, aber keine Eingänge enthalten. Die Einstiegsabdeckung wird sich mit der Zeit voraussichtlich verbessern.

Feedback

Dies ist eine experimentelle Funktion. Wir freuen uns über Ihr Feedback an buildings-in-geocoding-feedback-channel@google.com.