mapbox

type ApiError struct {
	Url        string
	HttpStatus string
	Message    string `json:"message,omitempty"`
	Code       string `json:"code,omitempty"`
}

type BannerComponent struct {
	Type            string   `json:"type"` // e.g., "icon", "text"
	Text            string   `json:"text"`
	Abbr            string   `json:"abbr"`
	AbbrPriority    int      `json:"abbr_priority"`
	ImageBaseUrl    string   `json:"imageBaseURL"`
	Directions      []string `json:"directions"`
	Active          bool     `json:"active"`
	ActiveDirection string   `json:"active_direction"`
}

type BannerContent struct {
	Text        string            `json:"text"`
	Type        string            `json:"type,omitempty"`
	Modifier    string            `json:"modifier,omitempty"`
	Degrees     int               `json:"degrees"`
	DrivingSide string            `json:"driving_side"`
	Components  []BannerComponent `json:"components"`
}

type BannerInstruction struct {
	DistanceAlongGeometry float64        `json:"distanceAlongGeometry"`
	Primary               BannerContent  `json:"primary"`
	Secondary             *BannerContent `json:"secondary,omitempty"`
	Sub                   *BannerContent `json:"sub,omitempty"`
}

type CategoryListItem struct {
	// [required] The canonical category ID to use in a category “Hot Button” search
	CanonicalId string `json:"canonical_id"`

	// [required] The Maki icon to use with the category
	Icon string `json:"icon"`

	// [required] The category name in the requested language
	Name string `json:"name"`

	Version string `json:"version,omitempty"`
	UUID    string `json:"uuid,omitempty"`
}

type CategoryListRequest struct {
	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`
}

type CategoryListResponse struct {
	// An array of category objects
	ListItems []CategoryListItem `json:"listItems"`

	// The attribution data for results.
	Attribution string `json:"attribution"`

	// The service version information. Include this information if you report an issue to Mapbox.
	Version string `json:"version"`
}

type CategoryRequest struct {
	// [required] the list of IDs can be retrieved with the /list/category endpoint
	CanonicalCategoryId string `url:"-"`

	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`

	// The number of results to return, up to 10.
	Limit limit `url:"-"`

	// Bias the response to favor results that are closer to a specific location.
	// Provide either ip to get results closest to the user's IP location or provide two comma-separated coordinates in longitude,latitude order.
	// If not provided, the default is IP proximity.
	// When both proximity and origin are provided, origin is interpreted as the target of a route, while proximity indicates the current user location.
	Proximity string `url:"proximity,omitempty"`

	// Limit results to only those contained within the supplied bounding box.
	// Bounding boxes should be supplied as four numbers separated by commas, in minimum longitude,minimum latitude,maximum longitude,maximum latitude order.
	// The bounding box cannot cross the 180th meridian.
	Bbox geojson.BoundingBox `url:"-"`

	// A comma-separated list of ISO 3166 alpha 2 country codes.
	Country string `url:"country,omitempty"`

	// Limit results to one or more types of features, provided as a comma-separated list.
	// Pass one or more of the type names as a comma separated list.
	// If no types are specified, all possible types may be returned.
	// Available types are: country, region, postcode, district, place, city, locality, neighborhood, street, address, poi, and category.
	Types string `url:"types,omitempty"`

	// A comma-separated list of canonical category names that limits POI results to those that are not part of the given categories.
	PoiCategoryExclusions string `url:"poi_category_exclusions,omitempty"`

	// Enable search-along-route (SAR) requests that shows the search results around the path provided with route parameter.
	// The only allowed value for this parameter is isochrone.
	SarType string `url:"sar_type,omitempty"`

	// When SAR is enabled, a polyline encoded linestring describing the route to be used for searching.
	// Both polyline5 and polyline6 precision are accepted, but must be specified using the route_geometry parameter.
	// Note that for /forward queries searching along a route, only brand and category searches are supported.
	Route string `url:"route,omitempty"`

	// When SAR is enabled, passed in conjunction with a route polyline describing its precision.
	// Options are polyline or polyline6.
	// If this parameter is not provided with a route, the default is polyline. Correct results depend on including the right route_geometry for the route provided.
	RouteGeometry string `url:"route_geometry,omitempty"`

	// When SAR is enabled, maximum detour allowed in estimated minutes from the route.
	TimeDeviation int `url:"time_deviation,omitempty"`
}

type ChargingWaypointMetadata struct {
	Type            string `json:"type"`
	Name            string `json:"name"`
	ChargeTime      int    `json:"charge_time"`
	ChargeTo        int    `json:"charge_to"`
	ChargeAtArrival int    `json:"charge_at_arrival"`
	PlugType        string `json:"plug_type"`
	CurrentType     string `json:"current_type"`
	PowerKw         int    `json:"power_kw"`
	StationId       string `json:"station_id"`
	ProviderNames   string `json:"provider_names"`
}

type ClientOption func(*MapboxClient)

type Coordinates struct {
	Longitude float64
	Latitude  float64
}

type DirectionsRequest struct {
	// [required] The routing profile to use. Possible values are mapbox/driving-traffic, mapbox/driving, mapbox/walking, or mapbox/cycling.
	//
	// Path parameter
	Profile RoutingProfile `url:"-"`

	// [required] A semicolon-separated list of between two and 25 {longitude},{latitude} coordinate pairs to visit in order.
	//
	// Path parameter
	Coordinates []Coordinates `url:"-"`

	// An alternative route is a route that is significantly different from the fastest route, but still close in time.
	// Such a route does not exist in all circumstances. Up to two alternatives may be returned.
	Alternatives bool `url:"alternatives,omitempty"`

	// Return additional metadata along the route. Must be used in conjunction with overview=full.
	Annotations string `url:"annotations,omitempty"`

	// Add a radius around the starting point in which the API will avoid returning any significant maneuvers.
	// Possible values are in the range from 1 to 1000 meters.
	// Use this option when the vehicle is traveling at a significant speed to avoid dangerous maneuvers when re-routing.
	AvoidManeuverRadius uint16 `url:"avoid_maneuver_radius,omitempty"`

	// Influences the direction in which a route starts from a waypoint.
	// Used to filter the road segment the waypoint will be placed on by direction.
	// This is useful for making sure the new routes of rerouted vehicles continue traveling in their current direction.
	Bearings string `url:"bearings,omitempty"`

	// Influences the layer of road from which a route starts from a waypoint.
	// Used to filter the road segment the waypoint will be placed on, in Z-order.
	// This is useful to avoid ambiguity in the case of multi-level roads (for example, a tunnel under a road).
	// Takes a single signed integer per waypoint.
	Layers string `url:"layers,omitempty"`

	// Sets the allowed direction of travel when departing intermediate waypoints.
	// If true, the route will continue in the same direction of travel.
	// If false, the route may continue in the opposite direction of travel.
	// Defaults to true for mapbox/driving and mapbox/driving-traffic, and false for mapbox/walking and mapbox/cycling.
	ContinueStraight bool `url:"continue_straight,omitempty"`

	// Exclude certain road types and custom locations from routing.
	// Default is to not exclude anything from the list below.
	// You can specify multiple values as a comma-separated list.
	Exclude string `url:"exclude,omitempty"`

	// The format of the returned geometry.
	// Allowed values are: geojson (as LineString),
	// polyline (default, a polyline with a precision of five decimal places),
	// polyline6 (a polyline with a precision of six decimal places).
	Geometries Geometry `url:"geometries,omitempty"`

	// Include certain additional road types for routing.
	// The default is to not include these road types.
	// You can specify multiple values as a comma-separated list.
	Include string `url:"include,omitempty"`

	Overview Overview `url:"overview,omitempty"`

	// Values can be any number greater than 0 or the string unlimited.
	Radiuses string `url:"radiuses,omitempty"`

	Approaches         string `url:"approaches,omitempty"`
	Steps              bool   `url:"steps,omitempty"`
	BannerInstructions bool   `url:"banner_instructions,omitempty"`
	Language           string `url:"language,omitempty"`
	RoundaboutExits    bool   `url:"roundabout_exits,omitempty"`
	VoiceInstructions  bool   `url:"voice_instructions,omitempty"`
	VoiceUnits         string `url:"voice_units,omitempty"`
	Waypoints          string `url:"waypoints,omitempty"`
	WaypointsPerRoute  bool   `url:"waypoints_per_route,omitempty"`
	WaypointNames      string `url:"waypoint_names,omitempty"`
	WaypointTargets    string `url:"waypoint_targets,omitempty"`
	Notifications      string `url:"notifications,omitempty"`

	WalkingParams
	DrivingParams
	DrivingTrafficParams
}

type DirectionsResponse struct {
	Code      string     `json:"code"`
	Waypoints []Waypoint `json:"waypoints"` // Legacy (root) or new waypoints_per_route
	Routes    []Route    `json:"routes"`
	UUID      string     `json:"uuid"`
}

type DrivingParams struct {
	AlleyBias float64 `url:"alley_bias,omitempty"`
	ArriveBy  string  `url:"arrive_by,omitempty"`
	DepartAt  string  `url:"depart_at,omitempty"`
	MaxHeight float64 `url:"max_height,omitempty"`
	MaxWidth  float64 `url:"max_width,omitempty"`
	MaxWeight float64 `url:"max_weight,omitempty"`
}

type DrivingTrafficParams struct {
	SnappingIncludeClosures       bool `url:"snapping_include_closures,omitempty"`
	SnappingIncludeStaticClosures bool `url:"snapping_include_static_closures,omitempty"`
}

type ForwardRequest struct {
	// [required] The user's query string. The query is limited to 256 characters.
	Query string `url:"q"`

	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`

	// The number of results to return, up to 10.
	Limit limit `url:"-"`

	// Bias the response to favor results that are closer to a specific location.
	// Provide either ip to get results closest to the user's IP location or provide two comma-separated coordinates in longitude,latitude order.
	// If not provided, the default is IP proximity.
	// When both proximity and origin are provided, origin is interpreted as the target of a route, while proximity indicates the current user location.
	Proximity string `url:"proximity,omitempty"`

	// Limit results to only those contained within the supplied bounding box.
	// Bounding boxes should be supplied as four numbers separated by commas, in minimum longitude,minimum latitude,maximum longitude,maximum latitude order.
	// The bounding box cannot cross the 180th meridian.
	Bbox geojson.BoundingBox `url:"-"`

	// A comma-separated list of ISO 3166 alpha 2 country codes.
	Country string `url:"country,omitempty"`

	// Limit results to one or more types of features, provided as a comma-separated list.
	// Pass one or more of the type names as a comma separated list.
	// If no types are specified, all possible types may be returned.
	// Available types are: country, region, postcode, district, place, city, locality, neighborhood, street, address, poi, and category.
	Types string `url:"types,omitempty"`

	// Limit results to those that belong to one or more categories, provided as a comma-separated list.
	PoiCategory string `url:"poi_category,omitempty"`

	// A comma-separated list of canonical category names that limits POI results to those that are not part of the given categories.
	PoiCategoryExclusions string `url:"poi_category_exclusions,omitempty"`

	// Enable Autocomplete Mode by setting the value to true.
	// When Autocomplete Mode is enabled, the search results will include partial and fuzzy matches.
	// This behavior enhances search functionality by suggesting potential matches as the user types, making it suitable for autocomplete implementations.
	Autocomplete string `url:"auto_complete,omitempty"`

	// Enable Estimate Time Arrival (ETA) calculation in the response.
	// The only allowed value for this parameter is navigation.
	// When this parameters is used, navigation_profile and either origin or proximity is also should be provided.
	// Enabling ETA calculations will introduce additional latency and incur extra costs,
	// as each search result for which ETAs are calculated (matrix elements) will be billed according to the Mapbox Matrix API pricing.
	EtaType string `url:"eta_type,omitempty"`

	// When ETA calculation is enabled, the navigation routing profile to use.
	// Available profiles are: driving, walking, and cycling.
	NavigationProfile string `url:"navigation_profile,omitempty"`

	// When ETA calculation is enabled, location from which to calculate distance.
	// Provided as two comma-separated coordinates in longitude,latitude order.
	// When both proximity and origin are provided, origin is interpreted as the target of a route,
	// while proximity indicates the current user location.
	Origin string `url:"origin,omitempty"`
}

type Geometry string

type Incident struct {
	Id              string   `json:"id"`
	Type            string   `json:"type"`
	Description     string   `json:"description"`
	LongDescription string   `json:"long_description"`
	CreationTime    string   `json:"creation_time"`
	StartTime       string   `json:"start_time"`
	EndTime         string   `json:"end_time"`
	Impact          string   `json:"impact"`
	LanesBlocked    []string `json:"lanes_blocked"`
	NumLanesBlocked uint8    `json:"num_lanes_blocked"`
	Congestion      struct {
		Value uint8 `json:"value"`
	} `json:"congestion"`
	Closed             bool     `json:"closed"`
	GeometryIndexStart int      `json:"geometry_index_start"`
	GeometryIndexEnd   int      `json:"geometry_index_end"`
	SubType            string   `json:"sub_type"`
	SubTypeDescription string   `json:"sub_type_description"`
	Iso31661Alpha2     string   `json:"iso_3166_1_alpha2"`
	Iso31661Alpha3     string   `json:"iso_3166_1_alpha3"`
	AffectedRoadNames  []string `json:"affected_road_names"`
	Sout               float64  `json:"south"`
	West               float64  `json:"west"`
	North              float64  `json:"north"`
	East               float64  `json:"east"`
}

type Intersection struct {
	Location        []float64 `json:"location"`
	Bearings        []int     `json:"bearings"`
	Classes         []string  `json:"classes"`
	Entry           []bool    `json:"entry"`
	GeometryIndex   int       `json:"geometry_index"`
	In              int       `json:"in,omitempty"`
	Out             int       `json:"out,omitempty"`
	Lanes           []Lane    `json:"lanes,omitempty"`
	Duration        float64   `json:"duration"`
	TunnelName      string    `json:"tunnel_name"`
	MapboxStreetsV8 struct {
		Class string `json:"class"`
	} `json:"mapbox_streets_v8"`
	IsUrban    bool `json:"is_urban"`
	AdminIndex int  `json:"admin_index"`
	RestStop   struct {
		Type string `json:"type"`
		Name string `json:"name"`
	} `json:"rest_stop"`
	TollCollection struct {
		Type string `json:"type"`
		Name string `json:"name"`
	} `json:"toll_collection"`
	RailwayCrossing bool `json:"railway_crossing"`
	TrafficSignal   bool `json:"traffic_signal"`
	StopSign        bool `json:"stop_sign"`
	YieldSign       bool `json:"yield_sign"`
}

type IsochroneFeature struct {
	// [required] This will always be "Feature".
	Type string `json:"type"`

	// [required] An object describing the spatial geometry of the returned feature.
	Geometry IsochroneFeatureGeometry `json:"geometry"`

	Properties IsochroneFeatureProps `json:"properties"`
}

type IsochroneFeatureGeometry struct {
	// [required] The coordinates of the feature, formatted as [longitude,latitude].
	Coordinates [][][]float64 `json:"coordinates"`

	// [required] This will always be "Point".
	Type string `json:"type"`
}

type IsochroneFeatureProps struct {
	Contour         int     `json:"contour,omitempty"`
	Color           string  `json:"color,omitempty"`
	Opacity         float64 `json:"opacity,omitempty"`
	Fill            string  `json:"fill,omitempty"`
	FillDashOpacity float64 `json:"fill-opacity,omitempty"`
	FillColor       string  `json:"fillColor,omitempty"`
	FillOpacity     float64 `json:"fillOpacity,omitempty"`
	Metric          string  `json:"metric,omitempty"`
}

type IsochroneRequest struct {
	Profile         RoutingProfile `url:"-"`
	Coordinates     Coordinates    `url:"-"`
	ContoursMinutes []uint8        `url:"contours_minutes,comma"`
	ContoursMeters  []uint32       `url:"contours_meters,comma"`

	ContoursColors []string `url:"contours_colors,omitempty,comma"`
	Polygons       bool     `url:"polygons,omitempty"`
	Denoise        float64  `url:"denoise,omitempty"`
	Generalize     float64  `url:"generalize,omitempty"`
	Exclude        string   `url:"exclude,omitempty"`
	DepartAt       string   `url:"depart_at,omitempty"`
}

type IsochroneResponse struct {
	Type     string             `json:"type"`
	Features []IsochroneFeature `json:"features"`
}

type Lane struct {
	Valid           bool     `json:"valid"`
	Active          bool     `json:"active"`
	ValidIndication string   `json:"valid_indication,omitempty"`
	Indications     []string `json:"indications"`
	Access          struct {
		Designated []string `json:"designated"`
	} `json:"access"`
}

type Logger interface {
	Debug(msg string, args ...any)
	Info(msg string, args ...any)
	Warn(msg string, args ...any)
	Error(msg string, args ...any)
}

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

type Overview string

type RetrieveRequest struct {

	// [required] path parameter
	MapboxId string `url:"-"`

	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`

	// Enable Estimate Time Arrival (ETA) calculation in the response.
	// The only allowed value for this parameter is navigation.
	// When this parameters is used, navigation_profile and either origin or proximity is also should be provided.
	// Enabling ETA calculations will introduce additional latency and incur extra costs,
	// as each search result for which ETAs are calculated (matrix elements) will be billed according to the Mapbox Matrix API pricing.
	EtaType string `url:"eta_type,omitempty"`

	// When ETA calculation is enabled, the navigation routing profile to use.
	// Available profiles are: driving, walking, and cycling.
	NavigationProfile string `url:"navigation_profile,omitempty"`

	// When ETA calculation is enabled, location from which to calculate distance.
	// Provided as two comma-separated coordinates in longitude,latitude order.
	// When both proximity and origin are provided, origin is interpreted as the target of a route,
	// while proximity indicates the current user location.
	Origin string `url:"origin,omitempty"`
	// contains filtered or unexported fields
}

type ReverseLookupRequest struct {
	// [required] The longitudinal coordinate of coordinate for the reverse query.
	Longitude float64 `url:"longitude"`

	// [required] The latitudinal coordinate of coordinate for the reverse query.
	Latitude float64 `url:"latitude"`

	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`

	// The number of results to return, up to 10.
	Limit limit `url:"-"`

	// A comma-separated list of ISO 3166 alpha 2 country codes.
	Country string `url:"country,omitempty"`

	// Limit results to one or more types of features, provided as a comma-separated list.
	// Pass one or more of the type names as a comma separated list.
	// If no types are specified, all possible types may be returned.
	// Available types are: country, region, postcode, district, place, city, locality, neighborhood, street, address, poi, and category.
	Types string `url:"types,omitempty"`
}

type Route struct {
	Duration        float64    `json:"duration"`
	Distance        float64    `json:"distance"`
	WeightName      string     `json:"weight_name"`
	Weight          float64    `json:"weight"`
	DurationTypical float64    `json:"duration_typical"`
	WeightTypical   float64    `json:"weight_typical"`
	Geometry        any        `json:"geometry"`
	Legs            []RouteLeg `json:"legs"`
	VoiceLocale     string     `json:"voiceLocale"`
	Waypoints       []Waypoint `json:"waypoints,omitempty"` // If waypoints_per_route is true
}

type RouteAnnotation struct {
	Congestion        []string  `json:"congestion,omitempty"`
	CongestionNumeric []float64 `json:"congestion_numeric,omitempty"`
	Distance          []float64 `json:"distance,omitempty"`
	Duration          []float64 `json:"duration,omitempty"`
	MaxSpeed          []struct {
		Speed   int    `json:"speed"`
		Unit    string `json:"unit"`
		Unknown bool   `json:"unknown"`
		None    bool   `json:"none"`
	} `json:"maxspeed,omitempty"`
	StateOfCharge []float64 `json:"state_of_charge,omitempty"`
	Speed         []float64 `json:"speed,omitempty"`
}

type RouteLeg struct {
	Distance        float64             `json:"distance"`
	Duration        float64             `json:"duration"`
	Weight          float64             `json:"weight"`
	DurationTypical float64             `json:"duration_typical"`
	WeightTypical   float64             `json:"weight_typical"`
	Steps           []RouteStep         `json:"steps"`
	Summary         string              `json:"summary"`
	Admins          []RouteLegAdmin     `json:"admins"`
	Incidents       []Incident          `json:"incidents"`
	Closures        []RouteLegClosure   `json:"closures"`
	Annotation      RouteAnnotation     `json:"annotation"`
	ViaWaypoints    []ViaWaypoint       `json:"via_waypoints"`
	Notifications   []RouteNotification `json:"notifications"`
}

type RouteLegAdmin struct {
	Iso31661Alpha3 string `json:"iso_3166_1_alpha3"`
	Iso31661       string `json:"iso_3166_1"`
}

type RouteLegClosure struct {
	GeometryIndexStart int `json:"geometry_index_start"`
	GeometryIndexEnd   int `json:"geometry_index_end"`
}

type RouteNotification struct {
	Type               string `json:"type"`
	Subtype            string `json:"subtype"`
	RefreshType        string `json:"refresh_type"`
	GeometryIndex      int    `json:"geometry_index"`
	GeometryIndexStart int    `json:"geometry_index_start"`
	GeometryIndexEnd   int    `json:"geometry_index_end"`
	StationId          string `json:"station_id"`
	Reason             string `json:"reason"`
	Details            struct {
		RequestedValue string `json:"requested_value"`
		ActualValue    string `json:"actual_value"`
		Unit           string `json:"unit"`
		Message        string `json:"message"`
	} `json:"details"`
}

type RouteStep struct {
	Maneuver        StepManeuver   `json:"maneuver"`
	Distance        float64        `json:"distance"`
	Duration        float64        `json:"duration"`
	Weight          float64        `json:"weight"`
	DurationTypical float64        `json:"duration_typical"`
	WeightTypical   float64        `json:"weight_typical"`
	Geometry        string         `json:"geometry"` // Polyline string or GeoJSON
	Name            string         `json:"name"`
	Ref             string         `json:"ref,omitempty"`
	Destinations    string         `json:"destinations"`
	Exits           string         `json:"exits"`
	DrivingSide     string         `json:"driving_side"`
	Mode            string         `json:"mode"`
	Pronunciation   string         `json:"pronunciation"`
	Intersections   []Intersection `json:"intersections,omitempty"`
	SpeedLimitSign  string         `json:"speedLimitSign"`
	SpeedLimitUnit  string         `json:"speedLimitUnit"`

	VoiceInstructions  []VoiceInstruction  `json:"voiceInstructions,omitempty"`
	BannerInstructions []BannerInstruction `json:"bannerInstructions,omitempty"`
}

type RoutingProfile string

type SearchResponse struct {
	// This will always be "FeatureCollection".
	Type        string                  `json:"type"`
	Features    []geojson.MapboxFeature `json:"features"`
	Attribution string                  `json:"attribution"`
}

type StepManeuver struct {
	BearingBefore float64   `json:"bearing_before"`
	BearingAfter  float64   `json:"bearing_after"`
	Instruction   string    `json:"instruction"`
	Location      []float64 `json:"location"`
	Modifier      string    `json:"modifier,omitempty"`
	Type          string    `json:"type"`
}

type SuggestRequest struct {

	// [required] The user's query string. The query is limited to 256 characters.
	Query string `url:"q"`

	// The ISO language code to be returned. If not provided, the default is English.
	Language string `url:"language,omitempty"`

	// The number of results to return, up to 10.
	Limit limit `url:"-"`

	// Bias the response to favor results that are closer to a specific location.
	// Provide either ip to get results closest to the user's IP location or provide two comma-separated coordinates in longitude,latitude order.
	// If not provided, the default is IP proximity.
	// When both proximity and origin are provided, origin is interpreted as the target of a route, while proximity indicates the current user location.
	Proximity string `url:"proximity,omitempty"`

	// Limit results to only those contained within the supplied bounding box.
	// Bounding boxes should be supplied as four numbers separated by commas, in minimum longitude,minimum latitude,maximum longitude,maximum latitude order.
	// The bounding box cannot cross the 180th meridian.
	Bbox geojson.BoundingBox `url:"-"`

	// A comma-separated list of ISO 3166 alpha 2 country codes.
	Country string `url:"country,omitempty"`

	// Limit results to one or more types of features, provided as a comma-separated list.
	// Pass one or more of the type names as a comma separated list.
	// If no types are specified, all possible types may be returned.
	// Available types are: country, region, postcode, district, place, city, locality, neighborhood, street, address, poi, and category.
	Types string `url:"types,omitempty"`

	// Limit results to those that belong to one or more categories, provided as a comma-separated list.
	PoiCategory string `url:"poi_category,omitempty"`

	// A comma-separated list of canonical category names that limits POI results to those that are not part of the given categories.
	PoiCategoryExclusions string `url:"poi_category_exclusions,omitempty"`

	// Enable Estimate Time Arrival (ETA) calculation in the response.
	// The only allowed value for this parameter is navigation.
	// When this parameters is used, navigation_profile and either origin or proximity is also should be provided.
	// Enabling ETA calculations will introduce additional latency and incur extra costs,
	// as each search result for which ETAs are calculated (matrix elements) will be billed according to the Mapbox Matrix API pricing.
	EtaType string `url:"eta_type,omitempty"`

	// When ETA calculation is enabled, the navigation routing profile to use.
	// Available profiles are: driving, walking, and cycling.
	NavigationProfile string `url:"navigation_profile,omitempty"`

	// When ETA calculation is enabled, location from which to calculate distance.
	// Provided as two comma-separated coordinates in longitude,latitude order.
	// When both proximity and origin are provided, origin is interpreted as the target of a route,
	// while proximity indicates the current user location.
	Origin string `url:"origin,omitempty"`
	// contains filtered or unexported fields
}

type SuggestResponse struct {
	Suggestions []Suggestion `json:"suggestions"`
	Attribution string       `json:"attribution"`
}

type Suggestion struct {
	// [required] The name of the feature.
	Name string `json:"name"`

	// [optional] The preferred name of the feature, if different than name.
	NamePreferred string `json:"name_preferred,omitempty"`

	// [required] The id to use with /retrieve to get full feature details.
	MapboxId string `json:"mapbox_id"`

	// [required] The type of the result.
	// For POIs, this will be poi.
	// For categories, this will be category.
	// For address-type results, the global context hierarchy is used (country, region, postcode, district, place, locality, neighborhood, address).
	FeatureType string `json:"feature_type"`

	// [optional] The address of the result containing the address number and street.
	Address string `json:"address,omitempty"`

	// [optional] The full address of the result, which concatenates address and place_formatted.
	FullAddress string `json:"full_address,omitempty"`

	// [required] A formatted string of result context comprised of the place, region, country, and postcode.
	PlaceFormatted string `json:"place_formatted"`

	// [required] The context of the feature. This context has layers that follow the Administrative unit types.
	Context geojson.MapboxContext `json:"context"`

	// [required] An IETF language tag indicating the language of the result.
	Language string `json:"language"`

	// [optional] A string representing an associated Maki icon to use for this result.
	Maki string `json:"maki,omitempty"`

	// [optional] An array including the POI categories the result falls into, if it is a POI.
	PoiCategory []string `json:"poi_category,omitempty"`

	// [optional] An array including the canonical POI category IDs the result falls into, if it is a POI.
	PoiCategoryIds []string `json:"poi_category_ids,omitempty"`

	// [optional] An array containing associated commercial brand names for the result, if it is a POI and is applicable.
	Brand []string `json:"brand,omitempty"`

	// [optional] An array containing canonical IDs of commercial brands for the result, if it is a POI and is applicable.
	BrandId []string `json:"brand_id,omitempty"`

	// [optional] An object containing the IDs of the feature found in external databases, with the keys being the data source names and the values being the IDs.
	ExternalIds map[string]string `json:"external_ids,omitempty"`

	// [optional] An object containing additional metadata for the feature, if applicable.
	Metadata map[string]any `json:"metadata"`

	// [optional] An approximate distance to the origin location, in meters.
	// If origin is not provided, it will show the approximate distance to the proximity location, in meters.
	Distance int `json:"distance,omitempty"`

	// [optional] The estimated time of arrival from the origin point to the feature, in minutes.
	// If origin is not provided, then this will be the estimated time of arrival from the proximity point to the feature, in minutes.
	// Only provided when eta_type, navigation_profile and origin/proximity are used in the request.
	// If an address is not on the road network, an ETA will not be provided.
	Eta int `json:"eta,omitempty"`

	// [optional] The distance added to an input route by including the given suggestion, in meters.
	AddedDistance int `json:"added_distance,omitempty"`

	// [optional] The estimated time added to an input route by including the given suggestion, in minutes.
	AddedTime int `json:"added_time,omitempty"`
}

type TimeZone struct {
	Identifier   string `json:"identifier"`
	Offset       string `json:"offset"`
	Abbreviation string `json:"abbreviation"`
}

type ViaWaypoint struct {
	WaypointIndex     int     `json:"waypoint_index"`
	DistanceFromStart float64 `json:"distance_from_start"`
	GeometryIndex     int     `json:"geometry_index"`
}

type VoiceInstruction struct {
	DistanceAlongGeometry float64 `json:"distanceAlongGeometry"`
	Announcement          string  `json:"announcement"`
	SSMLAnnouncement      string  `json:"ssmlAnnouncement"`
}

type WalkingParams struct {
	// The walking speed, in meters per second, with a minimum of 0.14 m/s (or 0.5 km/h) and a maximum of 6.94 m/s (or 25.0 km/h).
	// Defaults to 1.42 m/s (5.1 km/h).
	WalkingSpeed float64 `url:"walking_speed,omitempty"`

	// A scale from -1 to 1, where -1 biases the route against walkways and 1 biases the route toward walkways.
	// The default is 0, which is neutral.
	WalkwayBias float64 `url:"walkway_bias,omitempty"`
}

type Waypoint struct {
	Name     string                   `json:"name"`
	Location []float64                `json:"location"` // [longitude, latitude]
	TimeZone TimeZone                 `json:"time_zone"`
	Distance *float64                 `json:"distance,omitempty"`
	Metadata ChargingWaypointMetadata `json:"metadata"`
}