How to use PlayerMap

Tuesday 7 June 2016, by Horacio González Diéguez

All the versions of this article: [English] [Español] [galego]

*PlayerMap resurrects! Many of you have asked about the disappearance of SoundCloud groups feature, thanks to Pablo Blas and the team of Sonoteca Bahia Blanca I have just published a temporal solution they devised to load all the tracks of a user instead of the tracks of a group.

You can download the new version of PlayerMap on Github and write user: ’xxxxxx’ instead of group: ’xxxxxx’, to raise your maps. In order to get your user id go to the following URL:
https://api.soundcloud.com/resolve.json?url=http://soundcloud.com/+ YOUR_USER_NAME + &client_id=bfaf07dd601c910773c4c6d7550a0df3

Soon I will try to improve the code to allow concatenation of users so maps can show the tracks of a list of different users.

PlayerMap Tutorial | by Xoán-Xil

1. Create a SoundCloud account

You will need one or several accounts depending on the number of recordings you want to publish. SoundCloud service is quite limited and you will only be able to upload a few hours of sound for each account.

2. Create a group

PlayerMap will show all the tracks added to a SoundCloud group. This way, the creation of the sound map can be collaborative, as you will have the opportunity to invite other people to participate in your project. In addition, you will be able to add as many sounds as you want, even if you you exceed the limit of one account. Just remember that the group moderator must approve all contributions and that it is only possible to create one group per account.

PNG - 77.3 kb
SoundCloud menu to create groups - http://soundcloud.com/groups/new

3. Upload your recordings, add them to the group and use latitude and longitude tags

In addition to upload your recordings and add them to your SoundCloud group you will also have to introduce the location of each of the tracks you publish. For that you must use tags. In the upload form you will find a field to add them, copy and paste the geographical information following this example and remember to write both tags in quotation marks, always use the point to separate decimals and to write accurately.

"Lat:40.416775", "Lng:-3.703790"
PNG - 109.6 kb
SoundCloud upload form with the latitude and longitude tags you need to use - https://soundcloud.com/upload

* You can find the latitude and longitude of any place using the following website - http://www.latlong.net/convert-address-to-lat-long.html

4. Upload PlayerMap to your server

After adding some recordings to your group, download the script files from Github and upload them to your server. You may place them into a folder called map if you want.

PNG - 89.6 kb
Use an FTP browser to upload the files to your server

5. Edit index.html

Edit index.html script to include the your map’s URL and your SoundCloud group’s id. This is step is more complicated because it is not easy to find your group’s id.

a) In order to find the id of your group, open a SoundCloud API URL in your browser composed as follows

http://api.soundcloud.com/resolve.json?url= + SoundCloud group URL + &client_id=bfaf07dd601c910773c4c6d7550a0df3

For example, the address of the group that we have created for the demo map is - https://soundcloud.com/groups/my-sound-map -. To get its id we visited the following address - http://api.soundcloud.com/resolve.json?url=https://soundcloud.com/groups/my-sound-map&client_id=bfaf07dd601c910773c4c6d7550a0df3 -.

b) In the browser you will see all information about your group encoded in JSON. Don’t freak out, the second value in the list is the id of your group!

PNG - 92.3 kb
Find the id of your group using SoundCloud API

c) After writing your map’s URL instead of escribe_aqui_la_url_de_tu_mapa, copy and paste the id of your group instead of escribe_aqui_la_id.

PNG - 45.7 kb
Add your map’s URL and your group’s id in index.html

6. Share your sound map with us

Write us about your experience and share your sound map made with PlayerMap with us!

2015 VHPLab. I 2014 I 2013 I
Español I Galego