User Tools

Site Tools


api:dk11:delphi:gisutils.tgis_utils.gissunposition_tgis_point_tdatetime_double_double

Table of Contents

TGIS_Utils.GisSunPosition(TGIS_Point; TDateTime; Double; Double) method

DK11 for Delphi | GisUtils.TGIS_Utils.GisSunPosition | Overloads | Methods | Properties

Calculate sun's position based on time, date, and location on Earth

Available also on: .NET | Java | ActiveX | Python.

Syntax

// Delphi
public
  class procedure GisSunPosition(
    const _ptg : TGIS_Point;
    const _utc_time : TDateTime;
    var _altitude : Double;
    var _azimuth : Double
  ); overload;
// C++ Builder
public:
  __classmethod void GisSunPosition(
    TGIS_Point* const _ptg,
    TDateTime* const _utc_time,
    double &_altitude,
    double &_azimuth
  ) /* overload */;

Parameters

Name Type Description
_ptg TGIS_Point observer's location in geographic coordinate system expressed in radians
_utc_time TDateTime observer's time given in UTC (Coordinated Universal Time);
_altitude Double angular height in radians of the sun in the sky measured from the horizontal; values from 0 at sunrise and sunset to Pi/2 at solar noon (also known as an elevation angle)
_azimuth Double angle in radians in the horizontal plane measured clockwise from north to the horizontal projection of the sun's rays; values from 0 to 2*Pi

Remarks

This method is recommended to use to avoid the confusion associated with time zones and daylight saving time.

2024/12/20 22:20

Page Tools