User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.itgis_utils.gissunposition_itgis_point_tdatetime_double_double

Table of Contents

ITGIS_Utils.GisSunPosition method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_Utils.GisSunPosition | Methods | Properties

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

Available also on: Delphi | .NET | Java.

Syntax

// C#
public void GisSunPosition(
  ITGIS_Point _ptg,
  TDateTime _utc_time,
  ref double _altitude,
  ref double _azimuth
);
' VisualBasic
Public Sub GisSunPosition(
  ByVal _ptg As ITGIS_Point,
  ByVal _utc_time As TDateTime,
  ByRef _altitude As Double,
  ByRef _azimuth As Double
)
// Oxygene
public
  procedure GisSunPosition(
    _ptg : ITGIS_Point;
    _utc_time : TDateTime;
    var _altitude : Double;
    var _azimuth : Double
  );

Parameters

Name Type Description
_ptg ITGIS_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
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 elvation angle)
_azimuth double
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.

2020/05/07 01:05

Page Tools