educatedwarrior/xy-network

GeoLocation XY Network - EOSIO Smart Contracts

GeoLocation XY Network - EOSIO Smart Contracts

Roadmap

• Mapbox geometry.hpp compatible with EOSIO Smart Contracts
• GeoJSON & Map Vector Tile Services
• UI map example for Block Explorers

Map viewers

• Leaflet
• Leaflet Mapbox GL

API

ACTION

• createnode
• createway
• createrel
• erase
• move
• modify

STRUCT

• tag
• member

TABLE

• node
• way
• relation
• global

ACTION createnode

Create node (longitude & latitude) with tags

params

• {name} owner - creator of the node
• {point} node - point{x, y}
• {vector<tag>} tags - array of key & value tags

returns

{uint64_t} node id

example

cleos push action xy createnode '["myaccount", [45.0, 110.5], [{"k": "key", "v": "value"}]]'

ACTION createway

Create way with tags

params

• {name} owner - creator of the way
• {vector<point>} way - way
• {vector<tag>} tags - array of key & value tags

returns

{uint64_t} way id

example

cleos push action xy createway '["myaccount", [[45.0, 110.5], [25.0, 130.5]], [{"k": "key", "v": "value"}]]'

ACTION createrel

Create relation with tags

params

• {name} owner - creator of the way
• {vector<member>} member - array of member
• {vector<tag>} tags - array of key & value tags

returns

{uint64_t} member id

example

cleos push action xy createway '["myaccount", [{"type": "way", "ref": 1, "role": "outer"}], [{"k": "key", "v": "value"}]]'

ACTION erase

Erase node and all associated tags

params

• {name} user - authenticated user
• {vector<uint64_t>} ids - array of node identifiers

example

cleos push action xy erase '["myaccount", [0]]'

ACTION move

Move node to a new location

params

• {name} user - authenticated user
• {uint64_t} id - point identifier
• {point} node - point{x, y}

cleos push action xy move '["myaccount", 0, [45.0, 110.5]]'

ACTION modify

Modify tags from a node

params

• {name} user - authenticated user
• {uint64_t} id - node identifier
• {vector<tag>} tags - array of key & value tags

example

cleos push action xy modify '["myaccount", 0, [{"k": "key", "v": "value"}]]'

STRUCT tag

params

• {name} k - key
• {string} v - value

example

{
    "k": "building",
    "v": "yes"
}

STRUCT member

params

• {name} type - type of member (way or node)
• {uint64_t} ref - ref id of way or node
• {name} role - role of member

example

{
    "type": "way",
    "ref": 123,
    "role": "outer"
}

TABLE node

• {uint64_t} id - object unique identifier
• {point} node - point{x, y} coordinate
• {name} owner - creator of object
• {uint32_t} version - amount of times object has been modified
• {time_point_sec} timestamp - last time object was modified
• {checksum256} changeset - transaction ID used to last modify object
• {vector<tag>} tags - array of tags associated to object tag{key, value}

example

{
  "id": 0,
  "node": {"x": 45.0, "y": 110.5},
  "owner": "myaccount",
  "version": 1,
  "timestamp": "2019-08-07T18:37:37",
  "changeset": "0e90ad6152b9ba35500703bc9db858f6e1a550b5e1a8de05572f81cdcaae3a08",
  "tags": [ { "k": "key", "v": "value" } ]
}

TABLE way

• {uint64_t} id - object unique identifier
• {vector<uint64_t} refs - array of node ids
• {name} owner - creator of object
• {uint32_t} version - amount of times object has been modified
• {time_point_sec} timestamp - last time object was modified
• {checksum256} changeset - transaction ID used to last modify object
• {vector<tag>} tags - array of tags associated to object tag{key, value}

example

{
  "id": 0,
  "refs": [0, 1],
  "owner": "myaccount",
  "version": 1,
  "timestamp": "2019-08-07T18:37:37",
  "changeset": "0e90ad6152b9ba35500703bc9db858f6e1a550b5e1a8de05572f81cdcaae3a08",
  "tags": [ { "k": "key", "v": "value" } ]
}

TABLE relation

• {uint64_t} id - object unique identifier
• {vector<member} members - array of member{type, ref, role}
• {name} owner - creator of object
• {uint32_t} version - amount of times object has been modified
• {time_point_sec} timestamp - last time object was modified
• {checksum256} changeset - transaction ID used to last modify object
• {vector<tag>} tags - array of tags associated to object tag{key, value}

example

{
  "id": 0,
  "members": [{"type": "way", "ref": 1, "role": "outer"}],
  "owner": "myaccount",
  "version": 1,
  "timestamp": "2019-08-07T18:37:37",
  "changeset": "0e90ad6152b9ba35500703bc9db858f6e1a550b5e1a8de05572f81cdcaae3a08",
  "tags": [ { "k": "key", "v": "value" } ]
}

TABLE global

• {uint64_t} available_primary_key - global id for node/way/relation