Support existing URLs

[ezwelty]

Global URL parameters

• locale (default: 'en') – Language for interface and type common names: If not one of the supported translations (e.g. de, el, es, fr, it, nl, pl, pt-br), default to English (en). Load the regional variant if requested and supported (e.g. 'pt-BR': pt-br), and the parent language if not (e.g. 'fr-fr': fr). Load a regional variant if the parent language is not supported (e.g. 'pt': pt-br).

Map URL parameters

Applies to any of the several URLs (see next section) that loads a view of the map.

High priority

• x, y, z – Map longitude, latitude, and zom: Either map to @{y},{x},{z}z or rename @{y},{x},{z}z to x={x}&y={y}&z={z}
• m (default: 'true') – Municipal tree inventories: Set settings checkbox state and map to GET api/locations?muni=.
• f – Location types (comma-separated type ids): Set type filter state and map to GET api/locations?types=.
• c (default: 'forager,freegan') – Location type categories (forager, freegan, grafter, honeybee): Either map to type filter based on type.categories returned by GET api/types (not yet supported) or map to GET api/locations?categories= (not yet supported)

Low priority

• t (default: 'roadmap') – Map type ('roadmap': Google default, 'hybrid': Google satellite, 'toner-lite': Stamen toner-lite, 'OSM': OpenStreetMap default)
  • Set map type selection in settings.
  • Add missing map types (toner-lite, OSM)
• l (default: 'false') – Location labels: Set label checkbox state

Map URLs

• / – Redirect to /map
• /locations – Redirect to /map
• /home & /locations/home
  • Redirect to /map
  • Create an equivalent view for authenticated users
• /locations/embed
  • Redirect to /map (not ideal)
  • Redirect to minimalist map view
• /freegan & /dumpsters
  • Load with parameters c: 'freegan' or the equivalent type filter
  • Display custom modal on first load
  • Load with parameters t: 'toner-lite'
• /grafter
  • Load with parameters c: 'grafter' or the equivalent type filter
  • Display custom modal on first load
• /communityfruittrees – Load with parameters f: 4628, x: -99.09492, y: 38.48128, z: 5
• /seedlibrary & /seedlibraries – Load with parameters f: 3082, x: -99.09492, y: 38.48128, z: 5

Other URLs

Not yet supported

• /changes – Location changes : Create an equivalent view from GET api/locations/changes
• /routes – User routes (ordered collections of locations)
  • Redirect to /map
  • Rebrand (e.g. as "favorites" or "collections") and show to authenticated user from GET user/favorites (not yet supported)
• /routes/14 – User route
  • Redirect to /map
  • Show to authenticated user (or to all, if set to public) from GET user/favorites/{id} (not yet supported)

Already supported

• /about
• /press
• /sharing
• /data
• /datasets: Redirect to /data
• /maps: Support dropped
• /inventories: Support dropped
• /imports/14
• /locations/3383