geo

package

v0.1.304 Latest Latest Go to latest Published: May 20, 2025 License: Apache-2.0 Imports: 8 Imported by: 1

Details

This section is empty.

This section is empty.

func NewGoogleMapsClient(retryOpts helper.RetryOptions, opts MapsClientOptions) (*maps.Client, error)

type Client interface {
	contract.Geocoder
}

func NewClient(d Dependencies) (Client, error)

type DefaultTool struct {
	T *contract.Tool[Client]
}

func NewTool(c Client, opts contract.ToolOptions[Client]) *DefaultTool

func (d *DefaultTool) CityFromCoordinates(ctx context.Context, latitude, longitude float64) (string, error)

CityFromCoordinates retrieves the city name for given coordinates.

func (d *DefaultTool) GeocodeCoordinates(ctx context.Context, latitude, longitude float64) ([]maps.GeocodingResult, error)

GeocodeCoordinates retrieves geolocation data for given coordinates.

func (d *DefaultTool) IsUTC(ctx context.Context, t time.Time) (bool, error)

IsUTC checks whether a given time value is in UTC.

func (d *DefaultTool) SwapTimezone(ctx context.Context, t time.Time, tz string, toUTC, toMidnight bool) (time.Time, error)

SwapTimezone converts a time value to a specific timezone.

func (d *DefaultTool) TimezoneDataFromCoordinates(ctx context.Context, latitude, longitude float64) (*maps.TimezoneResult, error)

TimezoneDataFromCoordinates retrieves full timezone data for given coordinates.

func (d *DefaultTool) TimezoneFromCoordinates(ctx context.Context, latitude, longitude float64) (string, error)

TimezoneFromCoordinates retrieves the timezone ID for given coordinates.

type Dependencies struct {
	C contract.GoogleMaps
}

type Loaded struct {
	APIKey string
}

type MapsClientOptions struct {
	Loaded
	LimitPerSecond int
}

MapsClientOptions contains the options for the google maps client. A limit per second of 0 disable the rate limit.

func DefaultMapsClientOptions(APIKey string) MapsClientOptions

DefaultMapsClientOptions returns the default options for the google maps client.

type Tool interface {
	Client
}