Enhanced Location Reporting

The Enhanced Location Reporting feature will include more specific facility information such as SMDG, BIC, SPLC and FIRMS codes. Since this update changes the schema of a location object, it will not be enabled by default. To request this feature be enabled for your account, please contact support.

Definitions

• SMDG Codes - Codes for container handling terminal facilities called by seagoing cargo vessels at coastal ports. These codes are child codes of the UN/LOCODE, and managed by the Ship Message Design Group. The current list can be found at SMDG TERMINAL CODE LIST.

• BIC Codes - Codes for inland container facilities such as depots, container yards, container freight stations, etc. These are child codes of the UN/LOCODE, and managed by the Bureau of International Containers. More information can be found at BIC Facility Codes.

• Standard Point Location Codes (SPLC) - Data set complementary to UNECE and specific to North American rail. These codes are managed by the National Motor Freight Traffic Association (NMFTA). More information can be found at STANDARD POINT LOCATION CODE.

• FIRMS Codes - Four character alphanumeric code assigned by US Customs and Border Protection for Customs Service bonded facilities (e.g., Bonded Warehouses).

Examples

{
  ...location,
  "unlocode": "USORF",
  "splc_cd": null,
  "firms_cd": "L005",
  "bic_cd": "USORFYPQR",
  "smdg_cd": "USORFNIT",
  "geolocation": {
    ...
  }
}

{
  ...location,
  "unlocode": null,
  "splc_cd": "001400000",
  "firms_cd": null,
  "bic_cd": null,
  "smdg_cd": null,
  "geolocation": {
    ...
  }
}

📘

• Fields are optionally additive (backwards compatible) within the location object of the API response, and will only be returned when the enhanced location feature has been enabled.
• Facility codes will only be available when the source for the event location has provided enough information to correctly identify the specific facility.
• Note that not all codes will be present for a given location. They are dependent on the nature of the event, type of facilities that may exist there, and the relationship(s) that have been determined between them.
• It’s also important to note that with the addition of new data sets and facilities, not all locations will be expected to include a UN/LOCODE.