azimuth2compass

azimuth2compass(double azimuth [, int resolution [, int verbosity]])

The azimuth2compass function converts a numerical azimuth value (degrees of rotation from 0 degrees north) and converts it into a compass heading, such as N or Southeast. The exact text returned is controlled by two optional parameters, resolution and verbosity.

Resolution determines how fine-grained the values returned are. There are 4 possible values:

1 - Only the four cardinal directions are used (N, E, S, W)
2 (default) - Inter-cardinal directions (N, NE, E, etc.)
3 - In-between inter-cardinal directions (N, NNE, NE, ENE, E, etc.)
4 - "by" values (N, NbE, NNE, NEbN, NE, NEbE, ENE, EbN, E, etc.)

Verbosity affects how verbose the resulting text is. There are two possible values:

1 (default) - Use initials for direction values (N, NbE, NNE, etc.)
2 - Use full text for direction values (North, North by east, North-northeast, etc.)

For an azimuth value of 105, here are some example results of azimuth2compass:

azimuth2compass(105): E azimuth2compass(105, 3): ESE azimuth2compass(105, 4): EbS azimuth2compass(105, 1, 2): East azimuth2compass(105, 3, 2): East-southeast azimuth2compass(105, 4, 2): East by south