How-To Guides

Below is a list of guides that will show you how to achieve common tasks to get your day to day work done.

Transformations

• Geodetic to Projected Coordinates — transform lon/lat to easting/northing
• Axis Order Normalization — you'll hit this immediately
• Transformation With Area Of Interest — refining operation selection
• Operation Factory Context — advanced operation selection
• Pipeline Operator — chaining steps
• Batch Transformation — doing it at scale

Distance & Bounds

• Geodesic Distance & Azimuth — distance and bearing between two points
• Transforming Bounds — transform a bounding box between CRS

CRS & Database

• CRS Identification — identify an unknown CRS against the database
• Promote & Demote CRS to 3D — add or remove a height axis
• Database Querying — enumerate CRS entries from the PROJ database
• Serialization Formats — export CRS as WKT, PROJJSON, or PROJ string

Debugging

• Context Logging — capture PROJ diagnostic messages

Running

From the project root:

ruby -Ilib lib/examples/geodetic_distance.rb

If PROJ data files are not discoverable in your environment, see Configuration.