Solar API, bina türünü belirlemek için yer verilerini kullanır ve binaları uydu görüntülerine göre tanımlar. Bu sayfada, buildingInsights
isteğinde hangi binanın güneş enerjisi bilgilerinin döndürüleceğinin nasıl belirleneceği açıklanmaktadır.
Bina türleri
Solar API, premise
türündeki binaları destekler. Bu tür, genellikle ortak bir ada sahip bir bina veya bina grubu olan adlandırılmış bir konumu belirtir.
subpremise
veya yerleşkeler (ör. premise
olarak kaydedilmedikçe tek bir mülkte bulunan müstakil binalar) gibi diğer türler desteklenmez.
Bina çatıları
Solar API, uydu görüntülerine dayalı olarak çatı üstü güneş panellerinin en uygun yerleşimini belirler. Özellikle eğimli veya sivri çatıları olan konut binaları yüksek doğrulukla tanımlanırken, düz çatıları olan binalar (ör. apartmanlar veya ticari binalar) için doğruluk derecesi değişiklik gösterebilir.
buildingInsights
yanıtında solarPanelConfigs
alanı yoksa bina doğru şekilde işlenmiş ancak çatıya panel yerleştirilememiştir. Bu durum, çatı panel yerleştirilemeyecek kadar küçükse veya panellerin önemli miktarda enerji üretemeyecek kadar gölgeliyse ortaya çıkabilir.
Bir adresten arama yapma
Coğrafi Kodlama API'yi veya Place Autocomplete API'yi kullanarak bir adresi enlem ve boylam koordinatlarına dönüştürebilirsiniz.
Eşleşen yeri belirtmek için
place_id
öğesini kullanın.Solar API
buildingInsights
istekinizde yer enlem ve boylam koordinatlarını kullanın.- Solar API eşleşen bir bina bulursa
buildingInsights
yanıtındakiplace_id
değerinin, Geocoding API veya Place Autocomplete API'dekiplace_id
ile eşleşip eşleşmediğini kontrol edin. - Sonuçları
premise
türüne sahip yerlerle sınırlamak için Geocoding API veya Places API yanıtlarına bir yer türü filtresi ekleyin.{ "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs", "center": { "latitude": 37.4449739, "longitude": -122.13914659999998 },... }
- Solar API eşleşen bir bina bulursa
Solar API kapsamındaki binalar için place_id
değerini kontrol etmek üzere açık kaynak örnek uygulamayı kullanabilir veya buildingInsights
isteği gönderebilirsiniz.
Haritada bir konum seçme
Maps JavaScript API'yi kullanarak kullanıcıların haritadaki binayı seçmesine olanak tanıyarak da tamamlayıcı bir deneyim sunabilirsiniz. Fare etkinliğinden binanın enlem ve boylamını alıp bu koordinatları bir buildingInsights
isteğinde iletin.