{"id":"linked-art/api/places","relativePath":"linked-art/api/places.md","title":"Linked Art API: Places","markdown":"# Linked Art API: Places\n\n**Last refreshed:** 2026-07-06\n\nSource: [Places endpoint](https://linked.art/api/1.0/endpoint/place/), part of Linked Art API 1.0, published under [CC BY 4.0](http://creativecommons.org/licenses/by/4.0/). This is a project summary; the upstream page is authoritative.\n\n## Purpose\n\nThe Place endpoint describes spatial extents that provide context for activities and locations. A `Place` is independent of time and independent of which objects happen to be present there. Linked Art models place geometry with WKT in `defined_by`.\n\n## Required Shape\n\nA Place endpoint record dereferences to one JSON-LD object:\n\n- `@context`: Linked Art context URI, or an array ending with that URI for extensions.\n- `id`: dereferenceable HTTP(S) URI for the place.\n- `type`: `Place`.\n\n## Recommended Fields\n\n- `_label`: developer-facing label.\n- `classified_as`: classifications following the `Type` structure, such as city, nation, gallery, or room.\n- `identified_by`: `Name` and/or `Identifier` structures.\n\n## Optional Fields\n\n- `referred_to_by`: statements about the place.\n- `equivalent`: external identities.\n- `representation`: visual works representing the place.\n- `member_of`: sets that include the place.\n- `subject_of`: textual works focused on the place.\n- `attributed_by`: relationship assignment evidence.\n- `part_of`: broader place within which this place falls.\n- `defined_by`: WKT geometry string for the place.\n\n## Common Incoming Relationships\n\n- `took_place_at` from events and activities.\n- `current_location` from physical object records.\n- `current_permanent_location` from physical object records.\n- `moved_from` and `moved_to` from provenance `Move` activities.\n- `residence` from person and group records.\n\n## Meta Museum Notes\n\nMeta Museum already exposes places through `/api/places/{id}` and preserves full `Place` records through `/api/records/{id}`. Existing place coverage proves classifications, names, descriptions, `part_of` hierarchy, external `equivalent[]`, WKT `defined_by`, approximate place nesting, and `HumanMadeObject.current_location -> Place` references. The project also keeps buildings and other immovable human-made things as `HumanMadeObject` records rather than coercing them into `Place`.\n\n## Test Ideas\n\n- Keep `/api/places/{id}` role coverage aligned with `Place`.\n- Preserve a `Place` fixture with `classified_as`, `identified_by`, `referred_to_by`, `equivalent`, `part_of`, `member_of`, and `defined_by`.\n- Preserve incoming `current_location` and `produced_by.took_place_at` references from physical objects.\n- Preserve `moved_from` and `moved_to` place references in provenance movement activities.\n- Continue separating geographic places from buildings or immovable objects modeled as `HumanMadeObject`.\n","sections":[{"level":2,"heading":"Purpose","anchor":"purpose"},{"level":2,"heading":"Required Shape","anchor":"required-shape"},{"level":2,"heading":"Recommended Fields","anchor":"recommended-fields"},{"level":2,"heading":"Optional Fields","anchor":"optional-fields"},{"level":2,"heading":"Common Incoming Relationships","anchor":"common-incoming-relationships"},{"level":2,"heading":"Meta Museum Notes","anchor":"meta-museum-notes"},{"level":2,"heading":"Test Ideas","anchor":"test-ideas"}],"html":"<h1 id=\"linked-art-api-places\">Linked Art API: Places</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: <a href=\"https://linked.art/api/1.0/endpoint/place/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">Places endpoint</a>, part of Linked Art API 1.0, published under <a href=\"http://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">CC BY 4.0</a>. This is a project summary; the upstream page is authoritative.</p>\n<h2 id=\"purpose\">Purpose</h2>\n<p>The Place endpoint describes spatial extents that provide context for activities and locations. A `Place` is independent of time and independent of which objects happen to be present there. Linked Art models place geometry with WKT in `defined_by`.</p>\n<h2 id=\"required-shape\">Required Shape</h2>\n<p>A Place endpoint record dereferences to one JSON-LD object:</p>\n<ul><li>`@context`: Linked Art context URI, or an array ending with that URI for extensions.</li><li>`id`: dereferenceable HTTP(S) URI for the place.</li><li>`type`: `Place`.</li></ul>\n<h2 id=\"recommended-fields\">Recommended Fields</h2>\n<ul><li>`_label`: developer-facing label.</li><li>`classified_as`: classifications following the `Type` structure, such as city, nation, gallery, or room.</li><li>`identified_by`: `Name` and/or `Identifier` structures.</li></ul>\n<h2 id=\"optional-fields\">Optional Fields</h2>\n<ul><li>`referred_to_by`: statements about the place.</li><li>`equivalent`: external identities.</li><li>`representation`: visual works representing the place.</li><li>`member_of`: sets that include the place.</li><li>`subject_of`: textual works focused on the place.</li><li>`attributed_by`: relationship assignment evidence.</li><li>`part_of`: broader place within which this place falls.</li><li>`defined_by`: WKT geometry string for the place.</li></ul>\n<h2 id=\"common-incoming-relationships\">Common Incoming Relationships</h2>\n<ul><li>`took_place_at` from events and activities.</li><li>`current_location` from physical object records.</li><li>`current_permanent_location` from physical object records.</li><li>`moved_from` and `moved_to` from provenance `Move` activities.</li><li>`residence` from person and group records.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum already exposes places through `/api/places/{id}` and preserves full `Place` records through `/api/records/{id}`. Existing place coverage proves classifications, names, descriptions, `part_of` hierarchy, external `equivalent[]`, WKT `defined_by`, approximate place nesting, and `HumanMadeObject.current_location -&gt; Place` references. The project also keeps buildings and other immovable human-made things as `HumanMadeObject` records rather than coercing them into `Place`.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Keep `/api/places/{id}` role coverage aligned with `Place`.</li><li>Preserve a `Place` fixture with `classified_as`, `identified_by`, `referred_to_by`, `equivalent`, `part_of`, `member_of`, and `defined_by`.</li><li>Preserve incoming `current_location` and `produced_by.took_place_at` references from physical objects.</li><li>Preserve `moved_from` and `moved_to` place references in provenance movement activities.</li><li>Continue separating geographic places from buildings or immovable objects modeled as `HumanMadeObject`.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"5b00bba400106783ff516972ea10b6f8d41645f1201607c6a498729ff6b6279e","checksumPrefix":"5b00bba40010","anchorCount":7,"lineCount":55,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Fplaces.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Fplaces.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Fplaces.md"}