APIAny_CalcSunOnPlaceID

주어진 장소에서의 태양 위치를 계산합니다.

    GSErrCode ACAPI_Goodies (
        APIAny_CalcSunOnPlaceID,
        API_PlaceInfo*     placeInfo,

    );

파라미터

placeInfo

[in/out] 태양 위치의 파라미터들입니다.

API_PlaceInfo
`cityInd`	필수, city 속성의 인덱스입니다.
`sumTime`	필수, 일광 절약 on/off입니다.
`date`	필수, 1월 1일부터 시작하는 일 수입니다.
`time`	필수, 0:00 AM부터 시작하는 분 수입니다.
`north`	필수, 북쪽 방향입니다.
`sunAngX`Y	출력, 태양 각도입니다.
`sunAngZ`	출력, 태양 각도입니다.

리턴 값

NoError: 함수가 성공적으로 완료되었습니다.
APIERR_NOPLAN: 열린 프로젝트가 없습니다.
APIERR_BADPARS: placeInfo가 NULL입니다. 또는 유효하지 않은 데이터를 포함하고 있습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

설명

이 함수는 커스텀 장소에서 태양 각도들을 가져오는 데 사용합니다. 태양 각도들은 주어진 city와 특정 날짜 및 시간을 기반으로 계산됩니다. 계산된 각도들은 structure의 sunAngXY와 sunAngZ 필드들에게 리턴됩니다.

실제 위치 및 날짜 파라미터들을 가져오려면 APIEnv_GetPlaceSetsID 함수를 참조하십시오.

예제

API_PlaceInfo  placeInfo;
API_Attribute  attrib;
GSErrCode      err;

BNZeroMemory (&attrib, sizeof (API_Attribute));
attrib.header.typeID = API_CityID;
CHCopyC ("London", attrib.header.name);

err = ACAPI_Attribute_Search (&attrib.header);
if (!err) {

    BNZeroMemory (&placeInfo, sizeof (API_PlaceInfo));
    placeInfo.cityInd = attrib.header.index;
    placeInfo.sumTime = false;    /* winter time */
    placeInfo.date = 31 + 5;      /* febr. 5.   */
    placeInfo.time = 7 * 60;      /* seven o'clock */
    placeInfo.north = PI / 2;     /* up direction */

    err = ACAPI_Goodies (APIAny_CalcSunOnPlaceID, &placeInfo, NULL);
}

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Goodies.h

참고사항

API_PlaceInfo,
APIEnv_GetPlaceSetsID,
ACAPI_Goodies, API 함수