Wyszukaj budynki

Interfejs Solar API wykorzystuje dane o miejscach do określania typu budynku i identyfikuje budynki na podstawie zdjęć satelitarnych. Z tej strony 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.

Wskazówka: na podstawie innych metod wyboru, w tym ręcznego wyboru użytkowników lub niestandardowego wyboru programowego, możesz użyć punktu końcowego interfejsu Solar API dataLayers, aby tworzyć własne obliczenia potencjału słonecznego i umieszczać panele.

Wyszukiwanie z adresu

1. 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.

2. Użyj współrzędnych geograficznych szerokości i długości miejsca w żądaniu interfejsu Solar APIbuildingInsights.

   • Jeśli interfejs Solar API znajdzie pasujący budynek, sprawdź, czy place_id w odpowiedzi buildingInsights pasuje do place_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
     },...
     }

Uwaga: czasami identyfikatory miejsc nie będą się zgadzać, co oznacza, że wyszukiwane współrzędne (szerokość geograficzna, długość geograficzna) nie będą odpowiadać temu samemu adresowi lub budynkowi. Nawet jeśli odpowiedź interfejsu API do geokodowania jest szczegółowa (ROOFTOP), place_id może mieć typ inny niż premise.

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 informacje, umożliwiając im wybranie budynku na mapie za pomocą interfejsu Maps 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.