openelevation

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 14, 2026 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Package openelevation exposes the Open Elevation API as a kit Domain driver. A multi-domain host (ant) enables it with a single blank import:

import _ "github.com/tamnd/open-elevation-cli/open-elevation"

The same Domain also builds the standalone elevation binary (see cli/root.go), so the binary and a host share one source of truth.

Package openelevation is the library behind the elevation command line: the HTTP client, request shaping, and the typed data models for the Open Elevation API (api.open-elevation.com).

No API key required. The API is public and free. The Client sets a real User-Agent, paces requests to stay polite, and retries transient failures (429 and 5xx).

Index

Constants

View Source
const Host = "api.open-elevation.com"

Host is the site this client talks to.

Variables

This section is empty.

Functions

This section is empty.

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client talks to the Open Elevation API over HTTP.

func NewClient

func NewClient(cfg Config) *Client

NewClient returns a Client configured with cfg.

func (*Client) Batch

func (c *Client) Batch(ctx context.Context, coords [][2]float64) ([]Point, error)

Batch fetches elevations for multiple GPS coordinates in one POST request. coords is a slice of [lat, lon] pairs.

func (*Client) Lookup

func (c *Client) Lookup(ctx context.Context, lat, lon float64) (*Point, error)

Lookup fetches the elevation for a single GPS coordinate.

type Config

type Config struct {
	BaseURL   string
	UserAgent string
	Rate      time.Duration
	Timeout   time.Duration
	Retries   int
}

Config holds all tunable parameters for the Client.

func DefaultConfig

func DefaultConfig() Config

DefaultConfig returns a Config with sensible defaults.

type Domain

type Domain struct{}

Domain is the open-elevation driver.

func (Domain) Classify

func (Domain) Classify(input string) (uriType, id string, err error)

Classify turns "lat,lon" input into the canonical (type, id).

func (Domain) Info

func (Domain) Info() kit.DomainInfo

Info describes the scheme, the hostnames a pasted link is matched against, and the identity reused for the binary's help and version.

func (Domain) Locate

func (Domain) Locate(uriType, id string) (string, error)

Locate returns the live https URL for a (type, id).

func (Domain) Register

func (Domain) Register(app *kit.App)

Register installs the client factory and every operation onto app.

type Point

type Point struct {
	Latitude  float64 `json:"latitude"`
	Longitude float64 `json:"longitude"`
	Elevation float64 `json:"elevation"`
}

Point is one elevation result from the Open Elevation API.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL