geocoding

package

v0.0.0-...-46e3884 Latest Latest Go to latest Published: Feb 10, 2026 License: Apache-2.0 Imports: 12 Imported by: 0

Details

View Source

const DefaultGSIURL = "https://mreversegeocoder.gsi.go.jp/reverse-geocoder/LonLatToAddress"

View Source

const DefaultNominatimURL = "https://nominatim.openstreetmap.org/reverse"

View Source

var ErrGSIUnavailable = errors.New("GSI API is temporarily unavailable")

ErrGSIUnavailable indicates that the GSI API is temporarily unavailable (502/503/504)

func Echo(g *echo.Group, conf *HandlerConfig) error

type Area struct {
	Type   string  `json:"type"`
	Code   string  `json:"code"`
	Name   string  `json:"name"`
	Radius float64 `json:"radius"`
}

func BuildAreas(code string, includeRadii bool) ([]*Area, error)

type Areas struct {
	Address string  `json:"address"`
	Areas   []*Area `json:"areas"`
}

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

func NewGSIClient(httpClient *http.Client, url string) *GSIClient

func (c *GSIClient) Fetch(ctx context.Context, lon, lat float64) (*GSIResult, error)

type GSIResult struct {
	MunicipalityCode string
	Name             string
}

type HandlerConfig struct {
	GSIURL       string
	NominatimURL string
}

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

func NewNominatimClient(httpClient *http.Client, url, userAgent string) *NominatimClient

func (c *NominatimClient) Fetch(ctx context.Context, lon, lat float64) (*GSIResult, error)