BokaMera.API.Host

GeoDataCitiesQuery

The following routes are available for this service:
GET	/geodata/{CountryId}/cities/	Get all cities for a specific country	Get all information stored on the customer

**GeoDataCitiesQuery** Parameters:
Name	Parameter	Data Type	Required	Description
CountryId	path	string	Yes	Enter the country id you want to search cities. Example SE for Sweden.

**QueryBase** Parameters:
Name	Parameter	Data Type	Required	Description
Skip	query	int	No	Skip over a given number of elements in a sequence and then return the remainder. Use this when you need paging. Example: `?skip=10&orderBy=Id`
Take	query	int	No	Return a given number of elements in a sequence and then skip over the remainder. Use this when you need paging. Example: `?take=20`
OrderBy	query	string	No	Comma separated list of fields to order by. Prefix the field name with a minus if you wan't to invert the sort for that field. Example: `?orderBy=Id,-Age,FirstName`
OrderByDesc	query	string	No	Comma separated list of fields to order by in descending order. Prefix the field name with a minus if you wan't to invert the sort for that field. Example: `?orderByDesc=Id,-Age,FirstName`
Include	query	string	No	Include any of the aggregates `AVG, COUNT, FIRST, LAST, MAX, MIN, SUM` in your result set. The results will be returned in the meta field. Example: `?include=COUNT() as Total` or multiple fields with `?include=Count() Total, Min(Age), AVG(Age) AverageAge` or unique with `?include=COUNT(DISTINCT LivingStatus) as UniqueStatus`
Fields	form	string	No
Meta	form	Dictionary<string, string>	No

**City** Parameters:
Name	Parameter	Data Type	Required
Longitude	form	double	No
Latitude	form	double	No
Name	form	string	Yes
Country	form	string	Yes
Iso2	form	string	No
Admin	form	string	Yes
Capital	form	string	No
Population	form	int?	No
PopulationProper	form	int?	No
ModifiedDate	form	DateTimeOffset?	No
Id	form	Guid	Yes

**GeoDataCitiesQueryResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	Guid	No
City	form	string	Yes
Longitude	form	string	Yes
Latitude	form	string	Yes
Country	form	string	Yes
Iso2	form	string	Yes
Admin	form	string	Yes
Capital	form	string	Yes
Population	form	int?	No
PopulationProper	form	int?	No

**QueryResponse<T>** Parameters:
Name	Parameter	Data Type	Required
Offset	form	int	No
Total	form	int	No
Results	form	List<AccessKeyTypeResponse>	No
Meta	form	Dictionary<string, string>	No
ResponseStatus	form	ResponseStatus	No

**AccessKeyTypeResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
KeyType	form	string	Yes
Description	form	string	Yes

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /geodata/{CountryId}/cities/ HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsv

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	Offset: 0,
	Total: 0,
	Results: 
	[
		{
			City: String,
			Longitude: String,
			Latitude: String,
			Country: String,
			Iso2: String,
			Admin: String,
			Capital: String,
			Population: 0,
			PopulationProper: 0
		}
	],
	Meta: 
	{
		String: String
	},
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}