population

Documentation

Index

• type Area
• type AreaType
• type AreaTypes
• type Client
  • func NewClient(apiURL string) (*Client, error)
  • func NewWithHealthClient(hcCli *health.Client) (*Client, error)
  • func (c *Client) Checker(ctx context.Context, check *healthcheck.CheckState) error
  • func (c *Client) GetArea(ctx context.Context, input GetAreaInput) (GetAreaResponse, error)
  • func (c *Client) GetAreaTypeParents(ctx context.Context, input GetAreaTypeParentsInput) (GetAreaTypeParentsResponse, error)
  • func (c *Client) GetAreas(ctx context.Context, input GetAreasInput) (GetAreasResponse, error)
  • func (c *Client) GetDimensions(ctx context.Context, input GetDimensionsInput) (GetDimensionsResponse, error)
  • func (c *Client) GetPopulationAreaTypes(ctx context.Context, userAuthToken, serviceAuthToken, datasetID string) (GetAreaTypesResponse, error)
  • func (c *Client) GetPopulationTypes(ctx context.Context, input GetAreasInput) (GetAreasResponse, error)
• type Dimension
• type ErrorResp
  • func (e ErrorResp) Error() string
• type GetAreaInput
• type GetAreaResponse
• type GetAreaTypeParentsInput
• type GetAreaTypeParentsResponse
• type GetAreaTypesResponse
• type GetAreasInput
• type GetAreasResponse
• type GetDimensionsInput
• type GetDimensionsResponse

Types

type Area

type Area struct {
	ID       string `json:"id"`
	Label    string `json:"label"`
	AreaType string `json:"area_type"`
}

Area is an area model with ID and Label

type AreaType

type AreaType struct {
	ID         string `json:"id"`
	Label      string `json:"label"`
	TotalCount int    `json:"total_count"`
}

AreaType is an area type model with ID and Label

type AreaTypes

type AreaTypes struct {
	ID         string `json:"id"`
	Label      string `json:"label"`
	TotalCount int    `json:"total_count"`
}

Area is an area model with ID and Label

type Client

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

Client is a Cantabular Population Types API client

func NewClient

func NewClient(apiURL string) (*Client, error)

NewClient creates a new instance of Client with a given Population Type API URL

func NewWithHealthClient

func NewWithHealthClient(hcCli *health.Client) (*Client, error)

NewWithHealthClient creates a new instance of Client, reusing the URL and Clienter from the provided health check client

func (*Client) Checker

func (c *Client) Checker(ctx context.Context, check *healthcheck.CheckState) error

Checker calls recipe api health endpoint and returns a check object to the caller

func (*Client) GetArea

func (c *Client) GetArea(ctx context.Context, input GetAreaInput) (GetAreaResponse, error)

func (*Client) GetAreaTypeParents

func (c *Client) GetAreaTypeParents(ctx context.Context, input GetAreaTypeParentsInput) (GetAreaTypeParentsResponse, error)

func (*Client) GetAreas

func (c *Client) GetAreas(ctx context.Context, input GetAreasInput) (GetAreasResponse, error)

func (*Client) GetDimensions

func (c *Client) GetDimensions(ctx context.Context, input GetDimensionsInput) (GetDimensionsResponse, error)

func (*Client) GetPopulationAreaTypes

func (c *Client) GetPopulationAreaTypes(ctx context.Context, userAuthToken, serviceAuthToken, datasetID string) (GetAreaTypesResponse, error)

GetPopulationAreaTypes retrieves the Cantabular area-types associated with a dataset

func (*Client) GetPopulationTypes

func (c *Client) GetPopulationTypes(ctx context.Context, input GetAreasInput) (GetAreasResponse, error)

type Dimension

type Dimension struct {
	Name       string `json:"name"`
	Label      string `json:"label"`
	TotalCount int    `json:"total_count"`
}

Dimension is an area-type model with ID and Label

type ErrorResp

type ErrorResp struct {
	Errors []string `json:"errors"`
}

ErrorResp represents an error response containing a list of errors

func (ErrorResp) Error

func (e ErrorResp) Error() string

type GetAreaInput

type GetAreaInput struct {
	UserAuthToken    string
	ServiceAuthToken string
	PopulationType   string
	AreaType         string
	Area             string
}

type GetAreaResponse

type GetAreaResponse struct {
	Area Area `json:"area"`
}

GetAreasResponse is the response object for GET /areas

type GetAreaTypeParentsInput

type GetAreaTypeParentsInput struct {
	UserAuthToken    string
	ServiceAuthToken string
	DatasetID        string
	AreaTypeID       string
}

type GetAreaTypeParentsResponse

type GetAreaTypeParentsResponse struct {
	AreaTypes []AreaTypes `json:"area_types"`
}

GetAreaTypeParentsResponse is the response object for GET /areas

type GetAreaTypesResponse

type GetAreaTypesResponse struct {
	AreaTypes []AreaType `json:"area_types"`
}

GetAreaTypesResponse is the response object for GET /area-types

type GetAreasInput

type GetAreasInput struct {
	UserAuthToken    string
	ServiceAuthToken string
	DatasetID        string
	AreaTypeID       string
	Text             string
}

type GetAreasResponse

type GetAreasResponse struct {
	Areas []Area `json:"areas"`
}

GetAreasResponse is the response object for GET /areas

type GetDimensionsInput

type GetDimensionsInput struct {
	UserAuthToken    string
	ServiceAuthToken string
	Limit            int
	Offset           int
	PopulationType   string
	SearchString     string
}

type GetDimensionsResponse

type GetDimensionsResponse struct {
	cantabular.PaginationResponse
	Dimensions []Dimension `json:"items"`
}

GetDimensionsResponse is the response object for GetDimensions