anchor.diff:  
   Upcoming features can be tested in https://test.p.hsl.fi
   
  -== License
  +=== License
   
   Source code is licensed under AGPL and EUPL licenses. For details, see
   https://github.com/HSLdevcom/parkandrideAPI#license.
   
  +== General Features
  +
   [[authentication]]
  -= Authentication
  +=== Authentication
   
   Mutable operations require authentication using the `Authorization` header as shown in the following example.
   The value is the string `Bearer` followed by the API user's token.
  
positive.code: 
  
  [[facilities]]
  = Facilities
  
  [[facility-search]]
  == Search Facilities
  
  Facility collection resource allows filtering returned items by status, ids and location.
  These parameters can be mixed and matched to suite your use-case.
  
  === By Status
  
  Use multi-valued `statuses` parameter to filter by status, e.g. only facilities that are
  IN_OPERATION or have some EXCEPTIONAL_SITUATION:
  
negative.code: 
  You may test spatial searches with link:/#search-demo[Search Demo].
  
  ===== Within Shape
  
  If only `geometry` is specified, facilities whose location overlaps with it are returned.
  
  TODO: EXAMPLE!
  
  ===== Within Max Distance
  
  If `maxDistance` (double) is specified along side `geometry` then facilities whose location
  is within given max distance (meters) are returned.
  
  TODO: EXAMPLE!
  
  ==== Summary
  
  An existence of a special parameter named `summary` transforms results into a summary of matched
  facilities. This summary consists of `facilityCount` and sum of capacity by type.
  