Interfejs Solar API wykorzystuje dane o miejscach do określania typu budynku i identyfikuje budynki na podstawie zdjęć satelitarnych. Na tej stronie dowiesz się, jak określić, które informacje o słonecznym budynku są zwracane w ramach żądania buildingInsights
.
Typy budynków
Interfejs Solar API obsługuje budynki typu
premise
. Ten typ wskazuje nazwane miejsce, zwykle budynek lub zbiór budynków o wspólnej nazwie.
Inne typy, takie jak subpremise
lub kompleksy – na przykład budynki wolnostojące znajdujące się na jednej nieruchomości, chyba że są zarejestrowane jako premise
– nie są obsługiwane.
Dachy budynków
Interfejs Solar API określa optymalne miejsce na dachu na panele słoneczne na podstawie zdjęć satelitarnych. Budynki mieszkalne, zwłaszcza te z dachem spadzistym, są rozpoznawane z wysoką dokładnością, natomiast budynki z dachem płaskim (np. bloki mieszkalne lub budynki komercyjne) mogą być rozpoznawane z różnym stopniem dokładności.
Jeśli odpowiedź buildingInsights
nie zawiera pola solarPanelConfigs
, budynek został przetworzony prawidłowo, ale nie udało się umieścić paneli na dachu. Może się tak zdarzyć, jeśli dach jest za mały na panele lub za zacieniony, aby panele mogły wytwarzać znaczną ilość energii.
Wyszukiwanie z adresu
Adres możesz przekształcić w współrzędne geograficzne za pomocą interfejsu Geocoding API lub Place Autocomplete API.
Użyj elementu
place_id
, aby odwołać się do dopasowanego miejsca.Użyj współrzędnych geograficznych szerokości i długości miejsca w żądaniu interfejsu Solar API
buildingInsights
.- Jeśli interfejs Solar API znajdzie pasujący budynek, sprawdź, czy
place_id
w odpowiedzibuildingInsights
pasuje doplace_id
z interfejsu Geocoding API lub interfejsu Place Autocomplete API. - Aby ograniczyć wyniki do miejsc typu
premise
, dodaj do odpowiedzi interfejsów Geocoding API lub Places API filtr typu miejsca.{ "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs", "center": { "latitude": 37.4449739, "longitude": -122.13914659999998 },... }
- Jeśli interfejs Solar API znajdzie pasujący budynek, sprawdź, czy
Aby sprawdzić place_id
dla budynków objętych interfejsem Solar API, możesz użyć przykładowej aplikacji open source lub wysłać żądanie buildingInsights
.
Wybieranie lokalizacji na mapie
Możesz też zaoferować użytkownikom uzupełniające rozwiązanie, umożliwiając im wybór budynku na mapie za pomocą Map JavaScript API. Wyodrębnij współrzędne szerokości i długości geograficznej budynku z zdarzenia myszy, a potem prześlij te współrzędne w żądaniu buildingInsights
.