v1.0.1

• Release date: 2016-11-04. Live on prod 2016-11-04.
• Requires: tileserver v1.0.0 and tilequeue v1.0.1 and mapbox-vector-tile v1.0.0.
• Update boundaries query to use overlaps filter to improve performance.

v1.0.0-docs3

• [docs] Adds details on how to migrate to vector tiles 1.0 from earlier releases
• [docs] Edits to Display page and new 6-up house styles image

v1.0.0-docs2

• Documentation for Mapzen vector tile keys
• Fix test failure (upstream OpenStreetMap data change)

v1.0.0-docs1

Updated docs for v1.0.0 public release.

v1.0.0

See changelog for v1.0.0-pre1, v1.0.0-pre2, and v1.0.0-pre3.

v0.10.5-docs1

Documentation fixes for v0.10.5 release.

v1.0.0-pre3

• Release date: 2016-09-16 (dev build only as public preview)
• Requires: tileserver v0.8.0-pre2 and tilequeue v0.11.0-pre2 and mapbox-vector-tile v0.5.0.

---

• Developer preview URLs: API endpoints have generalized for multiple tile sets, accounts, and versions:
  • GeoJSON: http://tile.dev.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.json
  • TopoJSON: http://tile.dev.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.topojson
  • Mapbox Vector Tile: http://tile.dev.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.mvt
• Production URLs will be (not yet live):
  • GeoJSON: http://tile.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.json
  • TopoJSON: http://tile.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.topojson
  • Mapbox Vector Tile: http://tile.mapzen.com/mapzen/vector/v1/all/{z}/{x}/{y}.mvt

---

• Removed "not equals" YAML rule, which can be expressed using the other "equals" and "not" operators. PR #1044.
• BREAKING Rename sort_key to sort_rank. PR #1049.
• BREAKING Add /mapzen prefix to tilejson tiles URL. PR #1047.
• New version of "static" Natural Earth and OSM shapefiles. PR #1046.
• Restore buildings to zoom 13. PR #1036.
• BREAKING Fix scalerank 0 region boundaries. Drop name properties on boundaries at zoom <= 6. Add region boundaries sourced from Natural Earth "map_unit" data. PR #1037.
• Add min_zoom parameter to all features. PR #1031.
• Allow null refs in shield text. Attempt to sanitize shield text by omitting leading text such as A or M before numeric references. PR #1039.
• BREAKING Update Natural Earth road properties. Removes level, namealt and namealtt. Adds network and shield_text for some countries. PR #1035.
• BREAKING Fix filters for national forests and parks. Features are now required to have additional parameters (e.g: operator, protect_class, ...) to classify as a kind: national_park. PR #1034.
• Fix missing localized names on boundaries. Boundaries now include localized name:left:* and name:right:* where the data is available. PR #1022.
• Change min zoom for landuse, POIs to be closer to Bubble Wrap. Adds tier parameter to simplify client-side rendering rules. PR #997.

v1.0.0-pre2

• Release date: 2016-08-31 (dev build only as public preview 2016-09-07)

• See detailed Breaking changes, New features, Bug fixes, and Internal Changes sections below.

• Requires: tileserver v0.8.0-pre2 and tilequeue v0.11.0-pre2

  BREAKING CHANGES (v1.0.0-pre2)

• all layers: Revert to 2 letter language codes to remove client 3-char to 2-char shim logic, with better fallbacks. (#972)

• boundaries, places, and roads layers: Remove raw Natural Earth scalerank (see min_zoom instead) and labelrank properties. (#992)

• buildings layer: remove label placements from low- and mid-zooms, keep at zoom 16+. (#679)

• landuse layer: Low- and mid-zoom landuse polygons are now merged within the same kind values to significantly reduce file size. Some properties, like name, id, sport, religion, and surface are dropped, and the area is recalculated for new combo polygons. Planned work will add back some detail by adding scale_rank classes pre-merge (matching buildings layer behavior). (#583)

• landuse layer: Remove label placements for cemetery, farm, forest, forest, golf_course, grave_yard, military, national_park, natural_forest, natural_wood, nature_reserve, park, pitch, plant, protected_area, quarry, recreation_ground, substation, village_green, wastewater_plant, water_works, winter_sports, wood, works features, moving them to pois layer. Remaining label placements are recommended for text only label treatment.(#742)

• landuse layer: remove label placements from low- and mid-zooms, keep at zoom 15+. (#679)

• places layer: Additional locality changes for places layer to normalize place layer kinds: capital changes to country_capital, state_capital changes to region_capital, scientific_station localities get their own kind_detail, and other bug fixes for (#840). (#931)

• pois layer: Remove the cuisine property (see new kind_detail instead). (#719)

• pois layer: Modify default min_zoom for gate features. Gates on major roads are now visible at zoom 14, gates on intermediate roads at zoom 15, gates on minor roads at zoom 16, and gates not on roads at zoom 17 (was all zoom 15). (#820)

• roads layer: Remove aerialway, highway, piste_type, railway, in favor of coalescing their values into a new kind_detail property (and change incorrect subkind reference in documentation to kind_detail). (#970)

• transit layer: rename root_relation_id property to root_id, matching new building layer configuration. (#969 and #653)

• water layer: Remove duplicative and poor resolution sea polygons (but keep their label centroids) to save Venice and other cities from early global warming! This also addressed excessive sea labels in most Mapzen house styles. (#951)

  NEW FEATURES (v1.0.0-pre2)

• tilejson: Major upgrade to reflect all layers and properties. (#938)

• versioning: Add semantic versioning (semver) document detailing the promises Tilezen makes about major, minor, and patch versions and data model changes. (#948)

• buildings layer: Building parts may receive a root_id corresponding to the building feature, if any, with which they intersect. (#653)

• landuse layer: Add graveyard features. (#742)

• landuse layer: Add camp_site features for camp grounds. (#875)

• pois layer: Add cemetery, farm, forest, forest, golf_course, military, national_park, natural_forest, natural_wood, nature_reserve, park, pitch, plant, protected_area, quarry, recreation_ground, substation, village_green, wastewater_plant, water_works, winter_sports, wood, works features with adjusted zoom ranges over their previous availability in the landuse layer as label placements. All remaining label placements in the landuse layer are no longer recommended for icon label treatment. (#742)

• pois layer: Add graveyard features. (#742)

• pois layer: Add art gallery features. (#990)

• pois layer: Add kind_detail property sourced from sport for pitch features and sourced from cuisine for biergarten, pub, bar, restaurant, fast_food, cafe kinds (removing the cuisine property). (#719)

• roads layer: To support highway shields a new shield_text property has been added, network values have been normalized (and bicycle networks are now excluded). An example: for "US 101" we now store network of US:US and shield_text of 101. Multiple shields are supported via optional all_networks and all_shield_texts lists (which work in GeoJSON and TopoJSON but not MVT formats, follow mapbox-vector-tile/#64 for a fix). The ref property remains available but is less useful for shield construction. (#192 and #896)

  BUG FIXES (v1.0.0-pre2)

• all layers: Support fractional zoom for POIs, places, and other featues which were only appearing at the next whole integer tile, and rounds min_zoom values to 2 decimal places. For example: a feature with min_zoom of 14.8 was only appearing in zoom 15 tiles when it should have appeared in the zoom 14 tile. (#976)

• boundaries layer: Correct bug where sort_key mapping wasn't updated for new boundary kind values from v1.0.0-pre1. (#1012)

• places layer: Adjust default zoom ranges for Natural Earth localities at the low-zooms and Natural Earth and OpenStreetMap localities at mid- and high-zooms. (#981 and #982)

• places layer: Exclude region_capital=false properties. (#1003 and #931)

• pois layer: Add OpenStreetMap source attribution per feature. (#922)

• pois layer: Start querying for pois at z4, not z2 (matching the landuse layer). (#994)

• pois layer: Show large camp_site features at earlier zooms. (#875)

• pois layer: Removed transit halt, station, stop, and tram_stop features marked as historic. (#661)

• pois and landuse layers: Normalize operator values for United States National Park Service, United States Forest Service, and National Parks & WildlWildlifeife Service NSW in the U.S.A. and Australia. (#927)

• roads layer: Pedestrian paths and piers were missing bicycle: designated and related tags. Now that they are exported, they are correctly also decorated as is_bicycle_related: True. (#832)

• roads layer: Add additional properties sidewalk_left and sidewalk_right to all road layer features. (#605 and #986)

• roads layer: Remove crossing, sidewalk, sidewalk_left and sidewalk_right properties for road merge. (#993)

• roads layer: Drop meaningless id property on merged features. (#952)

• transit layer: Add OpenStreetMap source attribution per feature. (#935)

  DOCUMENTATION CHANGES (v1.0.0-pre2)

• documentation: Update earth layer documentation to reflect additional line and point geometry types. (#808)

• documentation: Update boundaries and landuse layer documentation to reflect barriers moving into the landuse layer. (#932)

• documentation: Update places layer d...

v0.10.5

• Release date: 2016-08-17
• Backport moving label generation to database. See #965.

v1.0.0-pre1

v1.0.0-pre1

• Release date: 2016-07-22 on dev as public preview

• See detailed Breaking changes, New features, Bug fixes, and Internal Changes sections below.

• Requires: tileserver v0.7.0 and tilequeue v0.10.0

  BREAKING CHANGES (v1.0.0-pre1)

• new url scheme: Mapzen now offers several different types of tiles in vector and raster formats and we combine data from multiple sources. The URL scheme has been updated to reflect this, and emphasize versions. The old URL will continue to work (~1 year), but updates will stop once v1.0.0 is released to production. (#652)

  • New dev URL: http://tile.dev.mapzen.com/vector/v1/all/{z}/{x}/{y}.topojson
  • Old dev URL was: http://vector.dev.mapzen.com/osm/all/{z}/{x}/{y}.topojson
  • New prod URL will be: https://tile.mapzen.com/vector/v1/all/{z}/{x}/{y}.topojson
  • Old prod URL is still: https://vector.mapzen.com/osm/all/{z}/{x}/{y}.topojson
  • New dev TileJSON is: http://tile.dev.mapzen.com/vector/v1/tilejson/mapbox.json
  • New prod TileJSON will be: https://tile.mapzen.com/vector/v1/tilejson/mapbox.json
  • Old prod TileJSON is still: https://vector.mapzen.com/osm/tilejson/mapbox.json

• roads layer: Reclassify airport runway and taxiways as new aeroway kind (was minor_road), and change their sort order to be under equivelant landuse polygons. (#895)

• roads layer: Reclassify road layer kind values sourced from Natural Earth to use OpenStreetMap style kind values. (#890)

• roads layer: Normalize several kind values to remove - and replace with _, including drive_through, j_bar, and t_bar. (#843)

• boundaries layer: Reclassify boundary layer kind values for some OpenStreetMap, including region (was state), locality (was municipality), and many country related kind changes from Natural Earth at low zooms. (#841)

• places layer: Normalize place layer kinds coming from OpenStreetMap and Natural Earth to more closely match Who's On First (mostly using locality kind, with new kind_detail storing the original OSM and NE values). See this lookup table for details. (#840)

• places layer: Remove country labels from zoom 0, 1 to reduce tile file size. (#837)

• places layer: Remove some types of OpenStreetMap neighbourhoods (borough, suburb, and quarter) in favor of Who's On First neighbourhoods. (#744)

• pois layer: Rename several kinds to distinguish aeroway_gate from gate, specify gas_canister shops (was gas which was confusing with automotive gas stations), and split off ski_rental if a ski feature was primarily a rental facility. (#844)

• landuse layer: Rename several kinds to distinguish natural_wood from wood parks, natural_forest from forest parks, and natural_park from natural parks. (#844)

• transit layer: route_name on line geometries is now simply name. (#729)

• landuse layer: Normalize urban_area landuse kinds from Natural Earth (was urban area). (#713)

• landuse and boundaries layers: Move barrier lines from boundaries layer into landuse layer. Includes city_wall, dam, fence, retaining_wall, and snow_fence. Watch out for dam which is now both a polygon and line in the same landuse layer. (#857)

• buildings layer: Reclassify building layer kind values to only have building or building_part, moved the earlier kind values to newnew kind_detail property with a whitelist of values. (#842)

• buildings layer: Reduce building payloads by merging buildings of similar type at zooms 13, 14, and 15 by dropping some properties like name, addr_housenumber, and addr_street, and quantizing others like height to 10 meters (zoom 13), 5 meters (zoom 14), and nearest meter (zoom 15). Also added new scalerank property with large buildings at 1 and small buildings at 5 to improve client-side style filtering & draw performance. (#845)

• Remove landuse-labels layer in favor of label placements in landuse layer and pois features. (#852)

• Use boolean values instead of 'yes' for properties likeosm_relation and label_placement. (#778)

• Names that have been localized now use the l10n language codes (ala Who's On First) for all data sources. For example: name:en imported from OpenStreetMap is exported as name:eng. (#418)

  NEW FEATURES (v1.0.0-pre1)

• roads layer: Add racetracks as type of minor_road sourced from OpenStreetMap's highway=raceway. See #664)

• roads layer: Add indoor corridors as type of path sourced from OpenStreetMap's highway=corridor. (#605)

• roads layer: Add properties for crossing=*, sidewalk=* to all road layer features. (#605)

• roads layer: Add bridleway as type of path. (#859)

• pois layer: Add toll_booth sourced from OpenStreetMap's barrier=toll_booth. (#479)

• pois and landuse layers: Add rest_area and service_area kinds sourced from OpenStreetMap's highway=rest_area and highway=services. (#480)

• places layer: Add localized names for Who's On First sourced neighbourhoods using l10n conventions. (#418)

• places layer: Add borough features from Who's On First (e.g.: Manhattan in New York City). (#654)

  BUG FIXES (v1.0.0-pre1)

• pois layer: Some walking network points were wrongly classified as rwn when they were actually iwn. (#844)

• pois and landuse layers: garden kind should win over attraction, and add garden point geometries (was previously limited to polygon features). (#829)

• pois layer: Show windmill features earlier, especially if they are a tourist attraction. (#830)

• pois layer: Show lighthouse features earlier, especially if they are a tourist attraction, as lighthouses. (#860)

• pois layer: Show camp grounds (camp_site) earlier. (#875)

• Update JSON encoding to handle invalid geometries (use the python round function), improves but does not completely solve invalid geometries in other formats like MVT. (#698)

• Drop all internal properties with a custom mz prefix, affected mz_is_building in landuse layer, but could have affected more layers. (#622)

  INTERNAL CHANGES (v1.0.0-pre1)

• pois layer: Remove several redundant filters for boat_storage, firepit, dry_cleaning, toilets, theatre, and picnic_site. (#844)

• Make pixel size threshold configurable for layers like landuse and water. (#202)

• For label placements, enable configurable pixel size threshold. (#810)

• Use json types and functions compatible with postgresql 9.3 to support better hstore tag usage. (#826)

• Migrate more pois layer transform functions to yaml (leisure, transit station states, aeroway gates). (#754.

• Add ability to set configurable buffer for MVT format per layer and geometry type. The default MVT config remains clipped (un-buffered), however. (#106)

• Remove TileStache dependency, moving Python transforms into vector-datasource repo. (#211)

CORRECTION: An earlier version of the release notes stated dev urls used https when they use http (without an API key postfixed). Also added breaking note about localized names now using l10n language codes. Also added label_placement to list of boolean examples.