Bina ara

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.

İpucu: Manuel kullanıcı seçimi veya özel programatik seçim gibi diğer seçim yaklaşımlarına göre kendi güneş enerjisi potansiyeli hesaplamalarınızı ve panel yerleşiminizi oluşturmak için Solar API dataLayers uç noktasını kullanabilirsiniz.

Bir adresten arama yapma

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

2. Solar API buildingInsights istekinizde yer enlem ve boylam koordinatlarını kullanın.

   • Solar API eşleşen bir bina bulursa buildingInsights yanıtındaki place_id değerinin, Geocoding API veya Place Autocomplete API'deki place_id ile eşleşip eşleşmediğini kontrol edin.
   • Sonuçları premise türündeki 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
     },...
     }
     

Not: Yer kimlikleri bazen eşleşmez. Bu durumda, aranan (lat, lng) aynı adrese veya binaya yönlendirmez. Coğrafi Kodlama API yanıtı ROOFTOP ayrıntı düzeyinde olsa bile place_id, premise dışında bir türe sahip olabilir.

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

Ayrıca, Maps JavaScript API'yi kullanarak kullanıcıların haritada binayı seçmesine olanak tanıyarak tamamlayıcı bir deneyim de sunabilirsiniz. Fare etkinliğinden binanın enlem ve boylamını alıp bu koordinatları bir buildingInsights isteğinde iletin.