Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Documentation for World Historical Gazetteer Latest Release
Logo
Documentation for World Historical Gazetteer Latest Release
  • Introduction
  • Guides & Tutorials
    • 1. Our Indexes
    • 2. Workbench
    • 3. Publishing Data
    • 4. Uploading Data
    • 5. Reconciliation & Accessioning
    • 6. Reviewing accessioning results
    • 7. Collection Groups
  • WHG Staff
    • 1. Gazetteer Configurator
    • 2. User API Profiles
    • 3. Site smoke test
    • 4. Atlas (staff notes)
  • Technical
    • 1. Repositories
    • 2. APIs
    • 3. Issues
  • Development Roadmap
    • 1. v4.0: Atlas, Collaborative Workbench, Phonetics
      • 1.1.1. Draft User Guide
        • 1.1.1.1. Getting Started
        • 1.1.1.2. Atlas: Exploring Places
        • 1.1.1.3. Map your Data
        • 1.1.1.4. Collaborative Collections
        • 1.1.1.5. Suggesting Corrections
        • 1.1.1.6. Sounds-alike Search
        • 1.1.1.7. Identifiers and Citation
        • 1.1.1.8. Data Formats In and Out
      • 1.1.2. Beta Testing Plan
      • 1.1.3. Data Model
        • 1.1.3.1. Introduction
        • 1.1.3.2. Overview
        • 1.1.3.3. Attestations & Relations
        • 1.1.3.4. Vocabularies
        • 1.1.3.5. Special SpatialEntity Patterns
        • 1.1.3.6. Contribution Types & Data Formats
        • 1.1.3.7. RDF Representation
        • 1.1.3.8. Platform Use Cases
        • 1.1.3.9. Summary & Future Directions
      • Toponym Phonetics: Technical Design
        • 1. Overview
        • 2. Elastic Management Guide
        • 3. Infrastructure Summary
        • 4. Components
        • 5. Data Flow
        • 6. Elasticsearch Index Design
        • 7. Training the Phonetic Similarity Model
        • 8. Query Pipeline
        • 9. Advantages of This Architecture
        • 10. Monitoring & Observability
        • 11. Future Extensions
        • 12. Deployment Plan
        • 13. Risk Assessment
        • 14. Success Criteria
        • 15. Summary & References
      • 1.1.4. System Architecture
        • 1.1.4.1. Database Technology Assessment
    • 2. v4.1: Open Educational Resources
    • 3. Archive: the 2025 v4 Design
      • 3.1. User Guide (2025 design)
        • 3.1.1. Quick Start Guide
        • 3.1.2. Understanding WHG Concepts
        • 3.1.3. Place Record Anatomy
        • 3.1.4. Contributing Data Overview
        • 3.1.5. Reconciliation Overview
        • 3.1.6. Tutorial: Creating a Historical Route
        • 3.1.7. Frequently Asked Questions
        • 3.1.8. Glossary
      • 3.2. Implementation in ArangoDB
      • 3.3. Kubernetes Configuration
      • 3.4. SSH Key Setup
      • 3.5. Deploying the Management Pod
      • 3.6. Deploying Services
      • 3.7. Service Configuration
  • License
Back to top
View this page
Edit this page
  • Introduction
    • Vision
    • Mission
  • Guides & Tutorials
    • 1. Our Indexes
      • 1.1. Wikidata+GeoNames Index (Augmentation)
      • 1.2. WHG Publication Index (Searchable Publication)
      • 1.3. WHG Union Index (Final Integration & Clustering)
    • 2. Workbench
      • 2.1. Individual datasets
      • 2.2. Multiple datasets
      • 2.3. Thematic place collections
        • 2.3.1. Instructional exercise in a class setting, or workshop
        • 2.3.2. Authored publication
    • 3. Publishing Data
      • 3.1. Create and publish a Place Collection
      • 3.2. Create and publish a Dataset Collection
    • 4. Uploading Data
      • 4.1. Choosing an upload data format: LPF or LP-TSV?
      • 4.2. Preparing data for upload
        • 4.2.1. The simple case
        • 4.2.2. The not so simple case: extracting places
        • 4.2.3. Linked Places format (LPF), a GeoJSON extension
      • 4.3. Getting the LP-TSV columns right
        • 4.3.1. Coordinates: lon and lat
        • 4.3.2. Place types: types and aat_types
        • 4.3.3. Feature classes: fclasses
        • 4.3.4. Updating a dataset
    • 5. Reconciliation & Accessioning
      • 5.1. What does closeMatch mean?
    • 6. Reviewing accessioning results
    • 7. Collection Groups
      • 7.1. Create and manage a Collection Group for a class or workshop
  • WHG Staff
    • 1. Gazetteer Configurator
      • 1.1. Where to find it
      • 1.2. What you’ll see
      • 1.3. Attribution, licence & rights
      • 1.4. Common tasks
        • 1.4.1. Adding a “core” gazetteer
        • 1.4.2. Hiding a gazetteer from the Regions panel
        • 1.4.3. Disabling Explore mode for a polygon-only gazetteer
      • 1.5. Re-ingestion
        • 1.5.1. Triggering a re-ingest
        • 1.5.2. Status lifecycle
        • 1.5.3. What “completed” actually means
        • 1.5.4. If a re-ingest gets stuck
      • 1.6. Permissions
    • 2. User API Profiles
      • 2.1. Where to find it
      • 2.2. What you’ll see
      • 2.3. Common tasks
        • 2.3.1. Bumping a researcher’s daily quota
        • 2.3.2. Resetting a user’s counter
        • 2.3.3. Investigating heavy usage
      • 2.4. Permissions
    • 3. Site smoke test
      • 3.1. What it checks
      • 3.2. Running it
      • 3.3. Dev shares the production Elasticsearch index
      • 3.4. Interpreting results
    • 4. Atlas (staff notes)
      • 4.1. Sections to be added
        • 4.1.1. Editorial review of submitted gazetteers
        • 4.1.2. Contributor oversight (“My Gazetteers”)
        • 4.1.3. Working / Preview-as-published toggle
        • 4.1.4. Volunteering, API, and Admin Dashboard relocations
        • 4.1.5. Retention sweep monitoring
        • 4.1.6. Gazetteers offcanvas — staff perspective
      • 4.2. Cross-references
  • Technical
    • 1. Repositories
    • 2. APIs
      • 2.1. Entity API
        • 2.1.1. Entity Endpoints
        • 2.1.2. Place Identifiers and Source Namespaces
        • 2.1.3. Persistent Identifiers (w3id.org)
      • 2.2. Reconciliation Service API
        • 2.2.1. What This Service Is For
        • 2.2.2. Reconciliation Endpoints
        • 2.2.3. The Query Model
        • 2.2.4. Batching, Quotas and Retries
        • 2.2.5. Query Parameters
        • 2.2.6. Source Namespaces
        • 2.2.7. Result Format
        • 2.2.8. Interpreting confidence
        • 2.2.9. Deciding Whether a Result Is Ambiguous
        • 2.2.10. Filter Behaviour and Common Pitfalls
        • 2.2.11. Geometry Recovery When the Top Hit Has No Centroid
        • 2.2.12. Data Extension Properties
        • 2.2.13. Using the WHG Reconciliation API in OpenRefine
      • 2.3. Source Terms and Attribution
        • 2.3.1. Where it appears
        • 2.3.2. Shape
        • 2.3.3. redistributable — which matches you will be able to fetch
        • 2.3.4. Mapping a result to its terms
        • 2.3.5. namespaces_searched
        • 2.3.6. The tri-state flags — null does not mean false
        • 2.3.7. The flags that carry obligations
        • 2.3.8. The WHG overlay
      • 2.4. API Tokens
        • 2.4.1. Using an API Token
        • 2.4.2. Suggest Endpoint Example
        • 2.4.3. Entity API Example
    • 3. Issues
  • Development Roadmap
    • 1. v4.0: Atlas, Collaborative Workbench, Phonetics
      • 1.1. The data model
        • 1.1.1. Draft User Guide
        • 1.1.2. Beta Testing Plan
        • 1.1.3. Data Model
        • Toponym Phonetics: Technical Design
        • 1.1.4. System Architecture
    • 2. v4.1: Open Educational Resources
      • 2.1. Vision
      • 2.2. Strategic Goals
      • 2.3. Technical Requirements
        • 2.3.1. OER Metadata Schema
        • 2.3.2. Data Model Extensions
        • 2.3.3. API Endpoints
        • 2.3.4. Frontend Components
        • 2.3.5. Integration Points
        • 2.3.6. Workflow for Creating OERs
        • 2.3.7. Technical Implementation Checklist
        • 2.3.8. Success Metrics
        • 2.3.9. Sustainability Considerations
        • 2.3.10. Documentation Needs
    • 3. Archive: the 2025 v4 Design
      • 3.1. User Guide (2025 design)
        • 3.1.1. Quick Start Guide
        • 3.1.2. Understanding WHG Concepts
        • 3.1.3. Place Record Anatomy
        • 3.1.4. Contributing Data Overview
        • 3.1.5. Reconciliation Overview
        • 3.1.6. Tutorial: Creating a Historical Route
        • 3.1.7. Frequently Asked Questions
        • 3.1.8. Glossary
        • 3.1.9. Getting Help
      • 3.2. Implementation in ArangoDB
        • 3.2.1. Overview
        • 3.2.2. Document Collections
        • 3.2.3. Indexing Strategy
        • 3.2.4. Query Patterns in AQL
        • 3.2.5. Handling Temporal Nulls and Geological Time
        • 3.2.6. ArangoDB Capabilities Assessment
        • 3.2.7. Summary
      • 3.3. Kubernetes Configuration
        • 3.3.1. Overview
        • 3.3.2. Setup
      • 3.4. SSH Key Setup
        • 3.4.1. 1. Generate an SSH Key
        • 3.4.2. 2. Copy the Public Key to the Remote Server
        • 3.4.3. 3. Log in to the Remote Server
        • 3.4.4. 4. Automatically Switch to the gazetteer Account
        • 3.4.5. 5. Check Kubernetes Nodes
        • 3.4.6. Secrets Management
      • 3.5. Deploying the Management Pod
        • 3.5.1. Accessing Kubernetes Dashboard and Services Locally
      • 3.6. Deploying Services
      • 3.7. Service Configuration
        • 3.7.1. Proposed Subdomain Mapping
  • License
    • Creative Commons Attribution-NonCommercial 4.0 International Public License
      • Section 1 – Definitions.
      • Section 2 – Scope.
      • Section 3 – License Conditions.
      • Section 4 – Sui Generis Database Rights.
      • Section 5 – Disclaimer of Warranties and Limitation of Liability.
      • Section 6 – Term and Termination.
      • Section 7 – Other Terms and Conditions.
      • Section 8 – Interpretation.
Copyright ©2017–2026 World Historical Gazetteer
Last updated on 28 September 2026