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 inbuilding_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. Eindisplay_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.