Tech:Product Misc

From Cyclopath

• routed must be run as user www-data:

  sudo -u www-data ./routedctl <WHATEVER>
  

• Standards: while this software uses terms like WFS and GML, it does not follow these standards. We had originally targed these standards but opted not to implement them because the effort/benefit ratio was too high. However, we do try to not do things in gratuitously incompatible ways.
• Many things currently rely on the global map object for transforming points between map space and canvas space.
• The location of the mouse while dragging is managed using global (Stage) coordinates, because the relative changes are the same and the local coordinate system sometimes changes during the course of a drag. (However, note that the stageX and stageY properties of a mouse event object are calculated using the current local to global transformation.)
• Byway one-way code: 0 means two-way, +1 means one-way in the "forward" direction (i.e., the order of vertices matches the one-way direction), and -1 means one-way in the backward direction.
• Ratings range between 0.0 and 4.0 inclusive.
• Generic rating: this is implemented with a pseudo-user that owns ratings in the database just like any other user. It is done this way so that the generic ratings aren’t "special" and can be used for things like item similarity calculation. NOTE: Each byway must have a generic rating or it will not be fetched.
• When using UIComponents in Flex, they will not be properly resized unless they are the child of a fully implemented Container (e.g., Canvas or Box, but just adding them to the Map_Canvas will not result in their correct sizing, because it only extends UIComponent and its own sizing is broken). Also, when reading the width and height attributes, the correct values are not visible until the frame after the resize is shown. The component will still draw correctly resized anyway.
• Z-order: geographic features have a Z attribute which defines their relative elevation order. Its purpose is to ensure correct visual rendering; it has no relationship to actual elevation nor can be used to draw conclusions about elevation relationships of nonintersecting objects. Higher Z values are closer to the viewer (who is looking down from above). Z values can be arbitrary integers, but are divided by custom into several ranges:

  110	Green space
  120	Water bodies
  130-139	Byways
  140	Points
  150	Watch Regions
  160	Geosummaries

  Once in the flashclient, integer Z is translated into floating point Z ⁺ , which is used to account for aesthetic needs. See comments for details.