Automated edits/PostBoxMap

From OpenStreetMap Wiki
Jump to navigation Jump to search


Who

  • OSM account: User:PostBoxMap
  • Operator: Luke / PostboxMap.co.uk
  • Contact: hello@postboxmap.co.uk

Motivation

We want OSM users to be able to click through from a post box node to the matching PostboxMap page and see photos and history for that box. PostboxMap already stores the OSM node id when we have matched the same physical box. This edit only adds a URL link the other way, on those already-matched nodes.

We first described this on Talk:Tag:amenity=post_box in July 2026. Creating new OSM nodes from our catalogue is out of scope.

See also Tag:amenity=post_box (UK heritage note) and PostboxMap Terms §8b.

Algorithm

  1. Select PostboxMap listings with status approved/imported and a stored osm_type/osm_id.
  2. Fetch the live element from the OSM API.
  3. Proceed only if:
    • the element is a node with amenity=post_box
    • the agreed link tag is absent, or already equals the canonical PostboxMap URL
    • if both PostboxMap reg_no and OSM ref exist, they match (trailing D optional)
    • if both have coordinates, distance ≤ 25 m
  4. Add only a tag whose value is https://postboxmap.co.uk/postbox/<id> (key to be agreed with the UK community; previously floated as source:postboxmap). Preserve all other tags and geometry.
  5. Never overwrite a different existing value for that key.
  6. Never create nodes, move nodes, or copy cypher/type/photos/coordinates from PostboxMap.

Frequency

Manual or scheduled batch runs after dry-run review. Pilot batches of ≤20 nodes; then regional batches.

Changeset tags

Opt-out

Email hello@postboxmap.co.uk with the OSM node id. We maintain an opt-out list and will not touch those elements.

Discussion

  • July 2026: described on Talk:Tag:amenity=post_box (PostboxMap added to UK section).
  • October 2026 forum: citation tag automated edit. Withdrawn after UK feedback on source:*; then un-withdrawn with a narrower click-through plan and an agreed key (no writes until the key is settled). Filling missing boxes is a separate, parked idea.