geocodio.go

package geocodio

import (
	"fmt"
	"os"
	"strings"
)

const (
	// GeocodioAPIBaseURLv1 is the Geocod.io Base URL
	GeocodioAPIBaseURLv1 = "https://api.geocod.io/v1.6"
)

// Geocodio is the base struct
type Geocodio struct {
	APIKey string
}

type Input struct {
	AddressComponents Components `json:"address_components"`
	FormattedAddress  string     `json:"formatted_address"`
}

// New creates a Geocodio instance based on an API key in either the environment
// or passed in as the first string value
func New(apiKey ...string) (*Geocodio, error) {

	key := os.Getenv(EnvGeocodioAPIKey)
	if strings.TrimSpace(key) == "" {
		key = os.Getenv(EnvOldAPIKey)
	}

	if len(apiKey) == 0 && strings.TrimSpace(key) == "" {
		return nil, ErrMissingAPIKey
	}

	if len(apiKey) == 1 {
		key = apiKey[0]
	}

	if strings.TrimSpace(key) == "" {
		return nil, ErrMissingAPIKey
	}

	g := Geocodio{
		APIKey: key,
	}

	return &g, nil
}

// NewGeocodio is a helper to create new Geocodio reference
// since 1.6+ this is kept for backwards compatiblity
// this is deprecatd and will be removed in 2+
func NewGeocodio(apiKey string) (*Geocodio, error) {

	fmt.Println(`
  NewGeocodio() is deprecated and will be removed in 2+
  Use geocodio.New("YOUR_API_KEY") 
  or with the environment variable ` + EnvGeocodioAPIKey + `
  Use geocodio.New()`)

	if apiKey == "" {
		return nil, ErrMissingAPIKey
	}

	g := Geocodio{
		APIKey: apiKey,
	}

	return &g, nil
}