The Temporal Gazetteer API is a webservice for querying historical placenames.

Introduction

TGAZ API - is a read-only interface designed to search the contents of the China Historical GIS placename database. The TGAZ system architecture -- based loosely on the CHGIS XML API (2006) -- has been normalized and made more generic in order to integrate multiple data sources, and to allow for vernacular spellings or transcription methods in many languages.

This interface accepts queries for placenames in UTF-8 encoded strings or glyphs (for example, Chinese Simplified or Complex characters). Each placename recorded in the database is referred to as a spelling. A brief look at the project in diagrams (PDF).

see also: A Research Bibliography on Temporal Gazetteers

Usage

Try this simple query form, or continue reading below for the API Usage Instructions:

The TGAZ web service is designed to receive RESTful URIs containing query values, and to return the results in XML format by default. The interface is READ-ONLY and currently provides two functions:

  1. Canonical Placename Search
    method -> http://maps.cga.harvard.edu/tgaz/placename/UNIQUE_ID
  2. Faceted Search
    method -> http://maps.cga.harvard.edu/tgaz/placename?QUERY_PARAMETER=VALUE

Instructions:

  1. Canonical Placename Records - replace UNIQUE_ID with the unique placename ID to be searched. (The IDs being used are being minted for the TGAZ database with the prefix hvd_. For example, the IDs listed in the CHGIS data layers would have the prefix added, such as CHGIS ID 32180 = TGAZ ID hvd_32180).
  2. Faceted Search - allows for a combinated of query parameters to be searched. A PLACENAME, YEAR, FEATURE TYPE, DATA SOURCE, and IMMEDIATE PARENT can be sent in the form of a query string, such as: ?n=mengla&yr=1820&ftyp=xian. Note: the default output is HTML, which can be reset using a FORMAT parameter, such as fmt=json

Blank spaces are accepted in the PLACENAME, FEATURE TYPE, IMMEDIATE PARENT values. Chinese Characters should be sent as plain UTF-8 encodings, not URLencoded hexadecimal strings. Note: for Chinese historical records the valid years of the database are -222 to 1911.

Canonical Placename

Canonical Placename Formats

Faceted Search

parameters allowed: