PSGC Terminology FHIR Implementation Guide
0.1.0 - ci-build Philippines flag

PSGC Terminology FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Geographic Lookup - XML Representation

Draft as of 2026-06-23

Raw xml | Download


<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="geo-lookup"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: DefinicionDeOperacion geo-lookup</b></p><a name="geo-lookup"> </a><a name="hcgeo-lookup"> </a><p>URL: [base]/CodeSystem/$geo-lookup</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>parent</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#code">code</a></td><td/><td><div><p>Parent PSGC code (trailing zeros stripped to form prefix)</p>
</div></td></tr><tr><td>IN</td><td>level</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#code">code</a></td><td><a href="ValueSet-psgc-geographic-level.html">PSGC Geographic Level</a> (Required)</td><td><div><p>Geographic level filter (Reg, Prov, City, Mun, SubMun, Bgy)</p>
</div></td></tr><tr><td>IN</td><td>version</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a></td><td/><td><div><p>PSGC release version. Defaults to latest.</p>
</div></td></tr><tr><td>OUT</td><td>match</td><td/><td>0..*</td><td/><td/><td><div><p>Matching codes</p>
</div></td></tr><tr><td>OUT</td><td>match.code</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#code">code</a></td><td/><td/></tr><tr><td>OUT</td><td>match.display</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#string">string</a></td><td/><td/></tr><tr><td>OUT</td><td>match.level</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R4/datatypes.html#code">code</a></td><td/><td/></tr></table></div>
  </text>
  <url
       value="https://australian-e-health-research-centre.gitlab.io/psgc-fhir-ig/OperationDefinition/geo-lookup"/>
  <version value="0.1.0"/>
  <name value="GeoLookup"/>
  <title value="Geographic Lookup"/>
  <status value="draft"/>
  <kind value="operation"/>
  <date value="2026-06-23T13:03:53+00:00"/>
  <publisher value="CSIRO Australian e-Health Research Centre"/>
  <contact>
    <name value="CSIRO Australian e-Health Research Centre"/>
    <telecom>
      <system value="url"/>
      <value value="https://aehrc.csiro.au"/>
    </telecom>
  </contact>
  <description
               value="Find PSGC codes by parent code prefix and/or geographic level. Exploits the positional encoding of the 10-digit PSGC code."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="PH"/>
      <display value="Philippines"/>
    </coding>
  </jurisdiction>
  <code value="geo-lookup"/>
  <resource value="CodeSystem"/>
  <system value="false"/>
  <type value="true"/>
  <instance value="false"/>
  <parameter>
    <name value="parent"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Parent PSGC code (trailing zeros stripped to form prefix)"/>
    <type value="code"/>
  </parameter>
  <parameter>
    <name value="level"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="Geographic level filter (Reg, Prov, City, Mun, SubMun, Bgy)"/>
    <type value="code"/>
    <binding>
      <strength value="required"/>
      <valueSet
                value="https://australian-e-health-research-centre.gitlab.io/psgc-fhir-ig/ValueSet/psgc-geographic-level"/>
    </binding>
  </parameter>
  <parameter>
    <name value="version"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation value="PSGC release version. Defaults to latest."/>
    <type value="string"/>
  </parameter>
  <parameter>
    <name value="match"/>
    <use value="out"/>
    <min value="0"/>
    <max value="*"/>
    <documentation value="Matching codes"/>
    <part>
      <name value="code"/>
      <use value="out"/>
      <min value="1"/>
      <max value="1"/>
      <type value="code"/>
    </part>
    <part>
      <name value="display"/>
      <use value="out"/>
      <min value="1"/>
      <max value="1"/>
      <type value="string"/>
    </part>
    <part>
      <name value="level"/>
      <use value="out"/>
      <min value="1"/>
      <max value="1"/>
      <type value="code"/>
    </part>
  </parameter>
</OperationDefinition>