# \[Announce\] node-red-contrib-map

**URL:** <https://discourse.nodered.org/t/announce-node-red-contrib-map/11735>\
**Category:** Share Your Nodes\
**Created:** [31 May 2019 17:13 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735 "2019-05-31T17:13:59Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![rsenden](https://sea2.discourse-cdn.com/flex026/user_avatar/discourse.nodered.org/rsenden/32/35728_2.png) [@rsenden](https://discourse.nodered.org/u/rsenden)\
**Post date:** [31 May 2019 17:13 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/1 "2019-05-31T17:13:59Z")

</div>

After having used Node-RED for only a couple of weeks, I have already implemented my first custom nodes.

The node-red-contrib-map plugin allows for defining re-usable mappings through configuration nodes; these mappings can then be used by the _map_, _set_ and _switch_ nodes provided by the plugin under the _mappings_ category.

Its main use is to define mappings between device id's and device names:

- The _map_ node allows you to map an incoming device id to a device name, and vice versa.
- The _set_ node allows for selecting a device from the configured mappings, and then add the device id or name to an incoming message.
- The _switch_ node allows for defining node outputs by matching incoming messages against the configured mappings. Note that this is somewhat similar to the _switch_ node provided by Node-RED, but dedicated for working with configured mappings.

I am successfully using this plugin in my own Node-RED flows, and it has allowed me to greatly simplify some of my flows.

If you have any feedback or experience any issues with this plugin, please let me know either here or through an issue on the GitHub page.

Note that the documentation at [https://flows.nodered.org/node/node-red-contrib-map](https://flows.nodered.org/node/node-red-contrib-map) has some formatting issues; you can view the correctly formatted documentation at either [https://www.npmjs.com/package/node-red-contrib-map](https://www.npmjs.com/package/node-red-contrib-map) or [https://github.com/rsenden/node-red-contrib-map](https://github.com/rsenden/node-red-contrib-map)

---

<div class="post-metadata">

**Author:** ![jmorris644](https://sea2.discourse-cdn.com/flex026/user_avatar/discourse.nodered.org/jmorris644/32/31964_2.png) [@jmorris644](https://discourse.nodered.org/u/jmorris644)\
**Post date:** [2 June 2019 13:02 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/2 "2019-06-02T13:02:21Z")

</div>

This looks e trembly useful!

Thanks

---

<div class="post-metadata">

**Author:** ![rsenden](https://sea2.discourse-cdn.com/flex026/user_avatar/discourse.nodered.org/rsenden/32/35728_2.png) [@rsenden](https://discourse.nodered.org/u/rsenden)\
**Post date:** [3 June 2019 12:01 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/3 "2019-06-03T12:01:29Z")

</div>

Version 1.0.1 was released earlier today:

- No functional changes
- Help information for the nodes has been updated:
  - Better adherence to the Node-RED help style guidelines
  - Some improvements to the help texts

- ReadMe file has been updated:
  - Fixed formatting/layout on [https://flows.nodered.org/node/node-red-contrib-map](https://flows.nodered.org/node/node-red-contrib-map)
  - Fixed links to example flows JSON code on [https://flows.nodered.org/node/node-red-contrib-map](https://flows.nodered.org/node/node-red-contrib-map)
  - Updated sample screenshot descriptions to describe what the example actually does, instead of just replicating the node help

---

<div class="post-metadata">

**Author:** ![Evan7](https://sea2.discourse-cdn.com/flex026/user_avatar/discourse.nodered.org/evan7/32/64141_2.png) [@Evan7](https://discourse.nodered.org/u/Evan7)\
**Post date:** [3 July 2022 13:57 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/4 "2022-07-03T13:57:02Z")

</div>

Any tutorials for beginners on how to use this ?

---

<div class="post-metadata">

**Author:** ![jbudd](https://avatars.discourse-cdn.com/v4/letter/j/5f8ce5/32.png) [@jbudd](https://discourse.nodered.org/u/jbudd)\
**Post date:** [3 July 2022 14:28 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/5 "2022-07-03T14:28:47Z")

</div>

I don't think this node is for plotting geographical maps such as the locations of Flemish banks.

---

<div class="post-metadata">

**Author:** ![Evan7](https://sea2.discourse-cdn.com/flex026/user_avatar/discourse.nodered.org/evan7/32/64141_2.png) [@Evan7](https://discourse.nodered.org/u/Evan7)\
**Post date:** [3 July 2022 14:54 UTC](https://discourse.nodered.org/t/announce-node-red-contrib-map/11735/6 "2022-07-03T14:54:00Z")

</div>

is there a better node that can do this ? @jbudd