This page is part of the Argonaut Provider Directory Guide (v0.1.0: Release 1 Draft) based on FHIR v1.9.0. The current version which supercedes this version is 1.0.0. For a full list of available versions, see the Directory of published versions
This profile sets minimum expectations for the Location resource for recording, searching for and fetching a Location associated with a provider or organizatino. It identifies which core elements, extensions, vocabularies and value sets SHALL be present in the resource when using this profile.
The following data-elements are mandatory (i.e data MUST be present). These are presented below in a simple human-readable explanation. Profile specific guidance and examples are provided as well. The Formal Profile Definition below provides the formal summary, definitions, and terminology requirements.
Each Location must have:
Each Location must have:
Each Location SHOULD have:
Profile specific implementation guidance:
The official URL for this profile is:
http://fhir.org/guides/argonaut-pd/StructureDefinition/argo-location
This profile builds on Location.
This profile was published on Wed Nov 09 00:00:00 AEDT 2016 as a draft by Argonaut Project.
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
Location.name
Location.telecom
Location.address
Location.managingOrganization
Each Location SHOULD have:
Location.type
Location.identifier
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Location | 0..* | Argonaut Provider Directory Location | ||
status | S | 0..1 | code | Binding: LocationStatus (required) |
name | S | 1..1 | string | |
identifier | S | 0..* | Identifier | |
type | S | 0..1 | CodeableConcept | |
telecom | S | 1..* | ContactPoint | |
address | S | 1..1 | Address | |
line | S | 0..2 | string | |
city | S | 0..1 | string | |
state | S | 0..1 | string | Binding: USPS Two Letter Alphabetic Codes (extensible) |
postalCode | S | 0..1 | string | US Zip Codes |
managingOrganization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | |
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Location | I | 0..* | Argonaut Provider Directory Location | |
id | ∑ | 0..1 | id | Logical id of this artifact |
meta | ∑ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!∑ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: Common Languages (extensible) | |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | S | 0..* | Identifier | Unique code or number identifying the location to its users |
status | ?!∑ | 0..1 | code | active | suspended | inactive Binding: LocationStatus (required) |
name | ∑ | 0..1 | string | Name of the location as used by humans |
alias | 0..* | string | A list of alternate names that the location is known as, or was known as in the past | |
description | ∑ | 0..1 | string | Additional details about the location that could be displayed as further information to identify the location beyond its name |
mode | ?!∑ | 0..1 | code | instance | kind Binding: LocationMode (required) |
type | S | 0..1 | CodeableConcept | Type of function performed Binding: ServiceDeliveryLocationRoleType (extensible) |
telecom | S | 1..* | ContactPoint | Contact details of the location |
address | S | 1..1 | Address | Physical location |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
use | ?!∑ | 0..1 | code | home | work | temp | old - purpose of this address Binding: AddressUse (required) Example' General': home |
type | ∑ | 0..1 | code | postal | physical | both Binding: AddressType (required) Example' General': both |
text | ∑ | 0..1 | string | Text representation of the address Example' General': 137 Nowhere Street, Erewhon 9132 |
line | S | 0..2 | string | Street name, number, direction & P.O. Box etc. Example' General': 137 Nowhere Street |
city | S | 0..1 | string | Name of city, town etc. Example' General': Erewhon |
district | ∑ | 0..1 | string | District name (aka county) Example' General': Madison |
state | S | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible) |
postalCode | S | 0..1 | string | US Zip Codes Example' General': 9132 |
country | ∑ | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) |
period | ∑ | 0..1 | Period | Time period when address was/is in use Example' General': {"start":"2010-03-23","end":"2010-07-01"} |
physicalType | ∑ | 0..1 | CodeableConcept | Physical form of the location Binding: LocationType (example) |
position | I | 0..1 | BackboneElement | The absolute geographic location |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
longitude | 1..1 | decimal | Longitude with WGS84 datum | |
latitude | 1..1 | decimal | Latitude with WGS84 datum | |
altitude | 0..1 | decimal | Altitude with WGS84 datum | |
managingOrganization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | Organization responsible for provisioning and upkeep |
partOf | 0..1 | Reference(Location) | Another Location this one is physically part of | |
endpoint | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the location | |
Documentation for this format |
Location.name
Location.telecom
Location.address
Location.managingOrganization
Each Location SHOULD have:
Location.type
Location.identifier
Differential View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Location | 0..* | Argonaut Provider Directory Location | ||
status | S | 0..1 | code | Binding: LocationStatus (required) |
name | S | 1..1 | string | |
identifier | S | 0..* | Identifier | |
type | S | 0..1 | CodeableConcept | |
telecom | S | 1..* | ContactPoint | |
address | S | 1..1 | Address | |
line | S | 0..2 | string | |
city | S | 0..1 | string | |
state | S | 0..1 | string | Binding: USPS Two Letter Alphabetic Codes (extensible) |
postalCode | S | 0..1 | string | US Zip Codes |
managingOrganization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | |
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Location | I | 0..* | Argonaut Provider Directory Location | |
id | ∑ | 0..1 | id | Logical id of this artifact |
meta | ∑ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!∑ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: Common Languages (extensible) | |
text | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
identifier | S | 0..* | Identifier | Unique code or number identifying the location to its users |
status | ?!∑ | 0..1 | code | active | suspended | inactive Binding: LocationStatus (required) |
name | ∑ | 0..1 | string | Name of the location as used by humans |
alias | 0..* | string | A list of alternate names that the location is known as, or was known as in the past | |
description | ∑ | 0..1 | string | Additional details about the location that could be displayed as further information to identify the location beyond its name |
mode | ?!∑ | 0..1 | code | instance | kind Binding: LocationMode (required) |
type | S | 0..1 | CodeableConcept | Type of function performed Binding: ServiceDeliveryLocationRoleType (extensible) |
telecom | S | 1..* | ContactPoint | Contact details of the location |
address | S | 1..1 | Address | Physical location |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
use | ?!∑ | 0..1 | code | home | work | temp | old - purpose of this address Binding: AddressUse (required) Example' General': home |
type | ∑ | 0..1 | code | postal | physical | both Binding: AddressType (required) Example' General': both |
text | ∑ | 0..1 | string | Text representation of the address Example' General': 137 Nowhere Street, Erewhon 9132 |
line | S | 0..2 | string | Street name, number, direction & P.O. Box etc. Example' General': 137 Nowhere Street |
city | S | 0..1 | string | Name of city, town etc. Example' General': Erewhon |
district | ∑ | 0..1 | string | District name (aka county) Example' General': Madison |
state | S | 0..1 | string | Sub-unit of country (abbreviations ok) Binding: USPS Two Letter Alphabetic Codes (extensible) |
postalCode | S | 0..1 | string | US Zip Codes Example' General': 9132 |
country | ∑ | 0..1 | string | Country (e.g. can be ISO 3166 2 or 3 letter code) |
period | ∑ | 0..1 | Period | Time period when address was/is in use Example' General': {"start":"2010-03-23","end":"2010-07-01"} |
physicalType | ∑ | 0..1 | CodeableConcept | Physical form of the location Binding: LocationType (example) |
position | I | 0..1 | BackboneElement | The absolute geographic location |
id | 0..1 | string | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
modifierExtension | ?!∑ | 0..* | Extension | Extensions that cannot be ignored |
longitude | 1..1 | decimal | Longitude with WGS84 datum | |
latitude | 1..1 | decimal | Latitude with WGS84 datum | |
altitude | 0..1 | decimal | Altitude with WGS84 datum | |
managingOrganization | S | 1..1 | Reference(http://fhir.org/guides/argonaut-pd/StructureDefinition-argo-organization) | Organization responsible for provisioning and upkeep |
partOf | 0..1 | Reference(Location) | Another Location this one is physically part of | |
endpoint | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the location | |
Documentation for this format |
Downloads: StructureDefinition: (XML, JSON, CSV), Schema: XML Schematron
Below is an overview of the required search and read operations.
Summary of Argonaut Search Criteria for StructureDefinition-argo-location
Clients
GET [base]/Location?name=[string]
GET [base]/Location?address=[string]
Servers
GET [base]/Location?name=[string]
A server has connected to a server and fetched a location by adress using GET [base]/Location?address=[string]
GET [base]/Location?name=[string]
Support: Mandatory
Implementation Notes: Search based on text name (how to search by string).
Response Class:
Example:
GET https://fhir-open-api-dstu2.smarthealthit.org/Location?name=Health
GET [base]/Location?address=[string]
Support: Mandatory
Implementation Notes: Search based on text address (how to search by string).
SHOULD also support the following search parameters:
Response Class:
Example:
GET https://fhir-open-api-dstu2.smarthealthit.org/Location?address=Arbor GET https://fhir-open-api-dstu2.smarthealthit.org/Location?address-postalcode=48104