As a result, links that go to the original page, such as in this comment (@Malvoz ) need to be updated to here. Sorry about that; not having an index page in the first place was a mistake.

https://maps4html.org/experiments/index.html should have a link to this repo.

Also, perhaps each experiment should link to the index and/or the repo.

Feel free to assign me.

Questions for tester

We've constructed a minimal test case map at https://maps4html.org/experiments/index.html. There are many aspects of an online map that are not present in this example, such as zoom and pan controls, search functionality, and so on. This map focuses only on "map features". A map feature (or "feature" in GIS parlance) represents a real-world location or area, such as an address, business, region, or arbitrary set of coordinates.

The goal of this map is to test the interaction with "map features", from the perspective of a screen reader user, or a sighted keyboard user. We'd want this to be tested without instructions, to see whether an assistive technology user can easily navigate and explore this map. We have a set of 10 questions that should be relatively simple to answer, below. We also welcome any feedback that are also relevant to this type of task. After the initial review, we'd like to have a conversation about any improvements we could make, and possibly to test more advanced or improved examples.

We suggest that the tester not read the whole list of questions first, but instead try to answer each question before moving on to the next.

1. How many restaurants are in this area?
2. How many of the map feature items are restaurants?
3. What type of restaurant is Big Daddy's?
4. How can you navigate to the next available map feature item? How many ways are there to do this?
5. How can you navigate to the previous available map feature item?
6. How can you navigate to the first and last available map feature item from another feature?
7. How do you close the expanded properties information popup?
8. Is there a way to hear all restaurants as a single list, without navigation necessary? Is that desirable?
9. How can you detect if you've reached the last available map feature item? What happens if you go beyond it? Can you return to it once you've navigated past it?
10. What keys do you use to navigate the map? Do they match your expectations?

Corresponding spec, polyfill, documentation and extension issues

This relates to the "Make the <mapml-viewer> self-perpetuating" epic. For these examples, it would be ideal to give the viewer the ability to copy/paste the markup that creates the example, similar to how the GeoGratis directory pages' templates work for individual layers, except it would be ideal to use a standard method/technique and not have to do too much work to obtain that result.

Per this documentation we should have a experiment showcasing the use of custom tiles (preferably of kittens 😃)

@yhy0217 @prushforth

Could we use this definition:

proj4.defs("ESRI:53032","+proj=aeqd +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +a=6371000 +b=6371000 +units=m +no_defs");

and these resolutions / scales to create a "custom projection" example pointing to this tile cache. My colleagues need a MapML source for this service and I would like to oblige.

To clarify to new visitors what to look for in the different experiments we should add short explainers, potentially with instructions.

For example in https://maps4html.org/experiments/screenreader/feature-index/ the visitor is supposed to tab to the map to reveal the feature index overlay, and then pan the map.

Internal to the polyfill, lines and polygons geometries are rendered using the "overlay pane", while points are rendered in the "marker pane". This causes an issue with interrupted feature focus tab ordering, that manifests as a problem with the skip block "next" and "previous" affordances.

Should the demo directory from the web custom element repository be added to this repository using github actions?

This issue is created to be linked to a PR that was created based on a brief verbal description of requirements.

We can use it to discuss how to improve the application, after initial merge, if necessary.

For a blind user, the visual map is not relevant. However, the features in the map could be relevant, much like a search result, if they were presented as a list of things, sorted in descending order of spatial relevance, which at a first approximation, and for this experiment could be taken to be "distance from the centre of the map".

I think that may be how maps are relevant to blind users - the content that sighted users can distinguish at a glance could be automatically ordered by the user agent based on space / spatial criteria.

cc @shepazu

Update

• https://maps4html.org/experiments/screenreader/closest-restaurants/
• https://maps4html.org/experiments/api/custom-map-ui/geoname-search-ui.html
• https://maps4html.org/experiments/api/custom-map-ui/geolocation-search-ui.html

Elements that are void elements in HTML but which were converted to non-void custom elements (e.g. <meta> => <map-meta></map-meta>) don't always have closing tags, compare:

Using Maps4HTML/Web-Map-Custom-Element#515 as a source of truth I believe they should all have closing tags
(</map-(meta|link|input)>). @prushforth can you confirm this?

Elements in other files such as i18n/rtl/restaurants.mapml were not changed in #61 and need to be converted too.