=== Solar Energy Simulator ===
Contributors: yotani
Author: Yuichiro Otani
Tags: solar, energy, simulation, electricity, solar-energy
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0
Requires PHP: 7.4
License: MIT
License URI: https://opensource.org/licenses/MIT

A multilingual solar energy simulation tool that estimates electricity savings based on regional inputs.

== Description ==
= English =
Solar Energy Simulator helps users simulate the yearly value of a solar panel installation based on electricity prices and estimated output. The plugin includes access to data on over 1,000,000,000 buildings globally, allowing users to find their own roof and draw a custom building if it's missing.
Simply configure your settings and use the shortcode [solar_energy_simulator] to display the calculator on your page.

= 日本語 =
Solar Energy Simulator は、電気料金と推定発電量に基づいてソーラーパネル設置の年間価値をシミュレートできるプラグインです。世界中の 10億以上の建物データ にアクセスでき、ユーザーは自分の屋根を見つけたり、見つからない場合は建物を描画して追加することも可能です。
設定を行い、ショートコード [solar_energy_simulator] を使用してページにシミュレーターを表示できます。

= Español =
Solar Energy Simulator permite simular el valor anual de una instalación solar según el precio de la electricidad y la producción estimada. Accede a información de más de 1.000 millones de edificios en todo el mundo y dibuja tu propio edificio si no está disponible.
Configura tus opciones y utiliza el shortcode [solar_energy_simulator].

= Français =
Solar Energy Simulator vous aide à simuler la valeur annuelle d'une installation solaire selon le prix de l'électricité et la production estimée. Le plugin donne accès à plus d’un milliard de bâtiments dans le monde entier, et vous pouvez dessiner votre propre bâtiment s’il n’est pas présent.
Configurez vos paramètres et utilisez le shortcode [solar_energy_simulator].

= 简体中文 =
Solar Energy Simulator 是一个插件，可根据电价和估算产量模拟太阳能装置的年价值。它包含全球 超过 10 亿栋建筑的数据，您可以查找自己的屋顶，或在建筑缺失时自行绘制。
只需配置设置并使用短代码 [solar_energy_simulator] 即可在页面中显示模拟器。
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/solar-energy-simulator` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Use the shortcode `[solar_energy_simulator]` in any post or page.

== Frequently Asked Questions ==
= Can I use this plugin in any country? =
Yes, you can set the electricity price manually based on your country.

= Is it compatible with block editor (Gutenberg)? =
Yes, the plugin works with both classic and block editors.

== Changelog ==
= 1.0 =
* Initial release.

== Upgrade Notice ==
= 1.0 =
First stable version.

== Screenshots ==
1. Frontend simulator
2. Admin settings page
3. Output preview

== License / ライセンス / Licencia / Licence / 许可协议 ==

= English =
This plugin is licensed under the **MIT License**.

= 日本語 =
このプラグインは **MITライセンス** のもとで配布されています。

= Español =
Este complemento está licenciado bajo la **Licencia MIT**。

= Français =
Ce plugin est sous licence **MIT**。

= 简体中文 =
本插件遵循 **MIT 许可协议**。

== Data Usage / データの利用 / Uso de datos / Utilisation des données / 数据使用 ==

= English =
All data retrieved from our Data API is **not** included in the MIT license. It is provided separately under terms defined by Otani & Co., Inc.  
This includes **building data** sourced from **Overture**. These datasets are subject to their own terms of service and licensing.  
The **GHI (Global Horizontal Irradiance)** data is used internally for calculations and is not delivered to users. It is sourced from the World Bank and published under the **CC BY 4.0 license**.

= 日本語 =
当社のデータAPIから取得されるすべてのデータは **MITライセンスには含まれません**。  
Otani & Co., Inc. によって定められた条件のもとで個別に提供されます。  
これには、**Overture** から取得した**建物データ**が含まれます。これらのデータセットには、それぞれの利用規約およびライセンスが適用されます。  
**GHI（Global Horizontal Irradiance）** データは計算にのみ使用され、ユーザーに提供されることはありません。  
World Bank から提供され、**CC BY 4.0** ライセンスで公開されています。

= Español =
Todos los datos obtenidos de nuestra API de datos **no están cubiertos** por la Licencia MIT.  
Se proporcionan por separado bajo los términos definidos por Otani & Co., Inc.  
Esto incluye los datos de **construcción** provenientes de **Overture**. Estos conjuntos de datos están sujetos a sus propios términos de servicio y licencias.  
Los datos de **GHI (Global Horizontal Irradiance)** se utilizan internamente para cálculos y no se entregan al usuario.  
Provienen del Banco Mundial y están licenciados bajo **CC BY 4.0**.

= Français =
Toutes les données récupérées depuis notre API de données **ne sont pas couvertes** par la licence MIT.  
Elles sont fournies séparément selon les termes définis par Otani & Co., Inc.  
Cela inclut les données de **bâtiment** provenant d’**Overture**. Ces ensembles de données sont soumis à leurs propres conditions d’utilisation et licences.  
Les données de **GHI (Global Horizontal Irradiance)** sont utilisées en interne pour des calculs et ne sont pas fournies à l’utilisateur.  
Elles proviennent de la Banque mondiale et sont publiées sous la licence **CC BY 4.0**.

= 简体中文 =
从我们的数据 API获取的所有数据 **不包含** 在 MIT 许可中。  
其使用受 Otani & Co., Inc. 另行规定的条款约束。  
这包括来自 **Overture** 的**建筑数据**，这些数据集受各自的服务条款和许可证约束。  
**GHI（Global Horizontal Irradiance）** 数据仅用于计算，不提供给用户。  
它来自世界银行并遵循 **CC BY 4.0** 许可协议。

== External Services ==

This plugin uses the following external JavaScript libraries:

1. **MapLibre GL JS**  
   - Homepage: https://maplibre.org  
   - License: BSD-2-Clause  
   - Purpose: Renders interactive web maps with vector tiles.  
   - Usage: Included locally in the plugin (`assets/admin/external/js/maplibre-gl.js`).

2. **Mapbox GL Draw**  
   - Homepage: https://github.com/mapbox/mapbox-gl-draw  
   - License: MIT  
   - Purpose: Allows drawing and editing of shapes on MapLibre maps.  
   - Usage: Included locally in the plugin (`assets/admin/external/js/mapbox-gl-draw.js`).

3. **iro.js**  
   - Homepage: https://iro.js.org/  
   - License: MIT  
   - Purpose: Provides a color picker for user configuration.  
   - Usage: Included locally in the plugin (`assets/admin/external/js/iro.js`).

4. **Turf.js**  
   - Homepage: https://turfjs.org  
   - License: MIT  
   - Purpose: Performs spatial calculations (e.g., area, distance, buffering).  
   - Usage: Included locally in the plugin (`assets/js/turf.min.js`).

5. **Custom Plugin Script**  
   - Purpose: Initializes and runs the solar energy simulator.  
   - Usage: Included as `assets/js/photovoltaic.js`.

All third-party libraries are bundled locally and do not depend on CDN or remote file loading.
