Użyj interfejsu Geocoding API, aby uzyskać zarysy budynków i ich wejścia, co pozwoli Ci ulepszyć wizualizację danych na mapie.
Aby to zrobić, dodaj do zapytania o geokodowanie dodatkowy parametr, który zwróci pary współrzędnych szerokości i długości geograficznej określające zarys budynku lub wejście. Użyj wyników swoich zapytań, aby na mapie narysować zarysy budynków i wskazywać wejścia do budynków.
- Kontur budynku to zbiór par współrzędnych szerokości i długości geograficznej, które definiują wielokąt 2D przedstawiający powierzchnię Ziemi pokrytą przez budynek.
- Wejście do budynku to pojedynczy zestaw współrzędnych szerokości i długości geograficznej, który określa lokalizację punktu wejścia i wyjścia z danego miejsca.
Użycie i zasięg
Możesz użyć tej usługi, aby zwrócić kontury wielokątów pojedynczego miejsca w ramach pojedynczego żądania. Oznacza to, że żądanie geokodu na poziomie miasta, np. Londyn, Wielka Brytania, nie zwraca konturów wszystkich budynków w danej lokalizacji. W takich przypadkach usługa zwróci standardową odpowiedź geokodowania bez konturów ani wejść do budynku. Usługa generuje zarysy i wejścia tylko w przypadku tych typów miejsc:
Obsługiwane typy miejsc
Budynek |
Wejścia |
|---|---|
|
|
|
|
|
|
|
Ta funkcja jest dostępna we wszystkich regionach, ale zasięg różni się w zależności od regionu. Oprócz tego możesz otrzymać odpowiedzi interfejsu API, które zawierają zarys budynku, ale nie zawierają danych o wejściu. W takim przypadku usługa zwróci odpowiedź geokodowania z konturem budynku, ale bez tablicy danych o wejściu. Usługa stale pracuje nad zwiększeniem zasięgu wejścia.
Szczegóły prośby
Kontury budynków i współrzędne wejść możesz uzyskać w ramach tych typów próśb:
W przypadku każdej z tych próśb musisz podać parametr extra_computations=BUILDING_AND_ENTRANCES.
Przykładowe żądanie
To zapytanie wykorzystuje geokodowanie miejsca, aby uzyskać informacje o wejściu i ogólne informacje o restauracji w Mountain View w Kalifornii w Stanach Zjednoczonych:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJl2tj2-62j4ARzKWl1WCXLJI&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY
Przykładowa odpowiedź
W większości przypadków odpowiedź zwraca jeden budynek wraz ze wszystkimi znanymi wejściami. W niektórych przypadkach odpowiedź może zawierać wiele budynków, np. punkty orientacyjne, które zajmują kilka budynków. Budynki i wejścia są reprezentowane przez te 2 tablice:
Tablica buildings[] z co najmniej 1 budynkiem. Każdy budynek zawiera te pola:
place_idUnikalny identyfikator budynku. Więcej informacji znajdziesz w artykule Omówienie identyfikatorów miejsc.
building_outlines[]Tablica konturów powiązanych z budynkiem. Ta tablica ma tylko 1 element. Każdy obiekt w polu
building_outlines[]ma takie pole:display_polygon
Kodowanie GeoJSON wielokąta, który przybliża powierzchnię ziemi pokrytą przez budynek, w formacie RFC 7946
tablica entrances[] z tymi polami:
locationwspółrzędne geograficzne szerokości i długości geograficznej wejścia,
building_place_idIdentyfikator miejsca w budynku w
buildings[], w którym znajduje się ten budynek. Dzięki temu możesz określić, które budynki mają które wejścia. Ten wejście odpowiada budynkowi o indeksieiw tablicybuildings[], gdziebuildings[i].place_id=building_place_id. Uwaga: ta wartość różni się od identyfikatora miejsca w wyniku geokodowania, chyba że wynik geokodowania dotyczy samego budynku. Ten parametr nie będzie zawsze wypełniany.entrance_tags[]Tablica tagów wejścia opisujących właściwości wejścia. Obsługiwana jest ta wartość:
"PREFERRED"Wskazuje, że ten wejście zapewnia fizyczny dostęp do zwróconego miejsca. Miejsce może mieć wiele preferowanych wejść. Jeśli wejście nie ma tego tagu, oznacza to, że znajduje się ono w tym samym budynku, ale niekoniecznie zapewnia dostęp do danego miejsca.
Jeśli np. zwróconym miejscem jest restauracja w centrum handlowym,
"PREFERRED"wejścia będą prowadzić do samej restauracji, a pozostałe zwrócone wejścia będą innymi wejściami do budynku, takimi jak wejścia do innych restauracji w centrum handlowym.Jeśli zwrócone miejsce to budynek,
"PREFERRED"wejścia będą prowadzić do „głównej” części budynku. Na przykład w centrum handlowym wejścia"PREFERRED"to te, które prowadzą do głównego holu, ale jeśli wejście umożliwia tylko wejście do sklepu z jednej strony budynku, nie będzie to wejście"PREFERRED".
Na obrazie poniżej widać zarys budynku i wejścia zwrócone w ramach przykładowego żądania.
Odpowiedź na przykładowe żądanie powyżej zawiera 2 wejścia i jeden budynek z konturem. Zwróć uwagę, że building_place_id każdego wejścia jest zgodny z place_id budynku:
{
"entrances": [
{
"building_place_id" : "ChIJU1erIO-2j4ARzlavxpYBJr8",
"location" :
{
"lat" : 37.3736684,
"lng" : -122.0540469
},
"entrance_tags": ["PREFERRED"]
},
{
"building_place_id" : "ChIJU1erIO-2j4ARzlavxpYBJr8",
"location" :
{
"lat" : 37.3738239,
"lng" : -122.0539773
},
}
],
"buildings" : [
{
"building_outlines" : [
{
"display_polygon" : {
"coordinates" : [
[
[
-122.054453349467,
37.3742345734776
],
[
-122.054665964955,
37.3737591984554
],
[
-122.054080317537,
37.3735936952922
],
[
-122.053867527481,
37.374069124071
],
[
-122.054453349467,
37.3742345734776
]
]
],
"type" : "Polygon"
}
}
],
"place_id" : "ChIJU1erIO-2j4ARzlavxpYBJr8"
}
],
}
Wyświetlanie kontur budynków na mapie
Interfejs JavaScript API ma wbudowane wsparcie dla wyświetlania wielokątów i wielokątów złożonych w formacie RFC 7946. Aby to zrobić:
- Utwórz obiekt funkcji za pomocą danych dotyczących wielokąta.
- Zastosuj styl do wielokąta.
- Dołącz funkcję do obiektu mapy JavaScript.
Każdy obiekt w tablicy buildings zawiera pojedynczy obiekt w tablicy building_outlines. Ten przykład pokazuje, jak wyświetlić na mapie zarys budynku:
//This function takes an argument of 'buildings', which is the buildings[] array returned by the API.
async function displayBuildingOutline(buildings) {
try {
//Import the Google Maps Data library.
const { Data } = await google.maps.importLibrary("maps")
//Loop though the array of building outlines.
buildings.forEach(building => {
const features = []
const buildingOutlines = building.building_outlines;
//Add each building outline to a Feature object, and push this to an array of Features.
buildingOutlines.forEach(buildingOutline => {
const feature = {
type: "Feature",
properties: {},
geometry: buildingOutline.display_polygon
}
features.push(feature);
});
//Create a new Google Maps Data object, and apply styling.
//We also assume the reference to the map on the page is named 'map'.
//This applies the Data object to the map on the page.
outlineLayer = new google.maps.Data({
map,
style: {
strokeColor: "#0085cc",
strokeOpacity: 1,
strokeWeight: 2,
fillColor: "#88d4fc",
fillOpacity: 0.5,
},
});
//Add the array of Features created earlier to the Data object, as GeoJson.
outlineLayer.addGeoJson({
type: "FeatureCollection",
features: features,
});
});
} catch (e) {
console.log('Building outlines failed. Error: ' + e)
}
}
Za pomocą kodu powyżej zarys budynku zwrócony przez interfejs Geocoding API w przykładowej odpowiedzi podanej wcześniej w tym dokumencie jest renderowany na mapie w ten sposób:
Obsługa odpowiedzi z wieloma budynkami lub konturem budynku
Możesz też napotkać te sytuacje, ale powyższy przykładowy kod będzie nadal działał:
- Pojedynczy obiekt
building_outlinesreprezentujący wiele wielokątów. - Odpowiedź z wieloma budynkami w tablicy
buildings[].
Na przykład odpowiedź dla identyfikatora miejsca ChIJGxgH9QBVHBYRl13JmZ0BFgo zawiera 2 budynki w tablicy buildings[]:
"buildings": [
{
"building_outlines": [
{
"display_polygon": {
"coordinates": [
[
[
44.3313253363354,
13.636033631612
],
[
44.3312576355624,
13.6362094887862
],
[
44.3310854239923,
13.6361461767801
],
[
44.3311531250111,
13.6359703194634
],
[
44.3313253363354,
13.636033631612
]
]
],
"type": "Polygon"
}
}
],
"place_id": "ChIJ24NWUBhUHBYRSEmPBFa1wgc"
},
{
"building_outlines": [
{
"display_polygon": {
"coordinates": [
[
[
44.330737534504,
13.6357057440832
],
[
44.3307248314371,
13.6357390350529
],
[
44.3306985591742,
13.635729486373
],
[
44.3307114066013,
13.6356960265536
],
[
44.330737534504,
13.6357057440832
]
]
],
"type": "Polygon"
}
}
],
"place_id": "ChIJpzQOABlUHBYRxiOC9goY1fE"
}
]
Za pomocą powyższego przykładowego kodu JavaScriptu możemy na mapie wyrenderować obrysy obu budynków:
Prześlij opinię
To funkcja eksperymentalna. Prześlij swoją opinię na adres geocoding-feedback-channel@google.com.