|
|
| (11 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | The enrichment of observations is a group of actions and/or replacements that take place over an observation in the process of delivering it ot its final destination or topic. They are placeholder substitutions, geolocation substitutions, proximity updates.
| |
| | | | |
| − | === Placeholder substitution ===
| |
| − |
| |
| − | A placeholder is a string with format #{placeholder_name} than can be used in certain fields of an observation where the placeholder substitution takes place. Actually there are three fields where this kind of substitution is considered:
| |
| − |
| |
| − | * topic
| |
| − | * producer
| |
| − | * targetthings
| |
| − |
| |
| − | Some substitutions occur in the process of building the observation in applications in the edge like the [[M2MBridge]] and others occur after the observation is sent to the AMTech's platform. This is mostly geolocation substitutions which is a special kind of placeholder substitution.
| |
| − |
| |
| − | === Geolocation substitution ===
| |
| − |
| |
| − | This is about doing placeholder substitution of a group of geolocation attributes than can be determined by using the <code>location</code> field of an observation. Based on the [[WKT]] that is given in the <code>location</code> field, a process of reverse geolocation is run and the address is determined when possible. These fields are then replaced if they appear in the <code>topic</code>, <code>producer</code> or <code>targetthings</code> fields of the original observation JSON.
| |
| − |
| |
| − | * #{country} or #{country_code}
| |
| − | * #{state} or #{province}
| |
| − | * #{postcode} or #{postal code} or #{zip code}
| |
| − | * #{city} or #{town}
| |
| − | * #{suburb} or #{residential} or #{city_district} or #{municipality} or #{neighbourhood}
| |
| − |
| |
| − | === Proximity updates ===
| |
