Wyszukaj budynki

Interfejs Solar API korzysta z danych o miejscach, aby określić typ budynku, i identyfikuje budynki na podstawie zdjęć satelitarnych. Na tej stronie dowiesz się, jak określić, które informacje o energii słonecznej budynku są zwracane w odpowiedzi na żądanie buildingInsights.

Typy budynków

Interfejs Solar API obsługuje budynki typu premise. Ten typ wskazuje nazwaną lokalizację, zwykle budynek lub zespół budynków o wspólnej nazwie.

Inne typy, takie jak subpremise lub kompleksy budynków – na przykład wolnostojące budynki znajdujące się na jednej posesji, chyba że są zarejestrowane jako premise – nie są obsługiwane.

Budowanie dachów

Interfejs Solar API określa optymalne miejsca instalacji paneli słonecznych na dachu na podstawie zdjęć satelitarnych. Budynki mieszkalne, zwłaszcza te z dachami skośnymi, są identyfikowane z dużą dokładnością, natomiast w przypadku budynków z płaskimi dachami (np. budynków mieszkalnych lub komercyjnych) dokładność może być różna.

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 zbyt mały, aby umieścić na nim panele, lub zbyt zacieniony, aby panele mogły generować znaczną ilość energii.

Wskazówka: w przypadku 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 utworzyć własne obliczenia potencjału solarnego i rozmieszczenia paneli.

Wyszukiwanie z adresu

1. Adres możesz przekonwertować na współrzędne geograficzne za pomocą interfejsu Geocoding API lub interfejsu Place Autocomplete API.

   Użyj elementu place_id, aby odwołać się do dopasowanego miejsca.

2. W żądaniu interfejsu Solar API użyj współrzędnych geograficznych miejsca.buildingInsights

   • 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 Place Autocomplete API.
   • Aby ograniczyć wyniki do miejsc typu premise, dodaj filtr typu miejsca do odpowiedzi interfejsu Geocoding API lub Places API.

     {
     "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 prowadzą do tego samego adresu lub budynku. Nawet jeśli odpowiedź interfejsu Geocoding API ma poziom szczegółowości ROOFTOP, element place_id może mieć typ inny niż premise.

Możesz użyć przykładowej aplikacji open source lub wysłać żądanie buildingInsights, aby sprawdzić place_id budynki objęte interfejsem Solar API.

Wybieranie lokalizacji na mapie

Możesz też zaoferować dodatkowe funkcje, umożliwiając użytkownikom wybieranie budynku na mapie za pomocą Maps JavaScript API. Wyodrębnij szerokość i długość geograficzną budynku z zdarzenia myszy, a następnie przekaż te współrzędne w żądaniu buildingInsights.