Run the Tiled editor and follow these steps:

This is how your Tiled editor should look at this point:

Allow us to direct your attention towards the TiledMapObjectsSample.java file. Here we load and render the data/maps/tiled-objects.tmx file very much like in the previous recipe. Additionally, we place the player, enemy, and items sprites as well as show the position and dimensions of triggers as per the map's objects. Finally, we also play the audio file in the map's properties.

This way you will see how easy it is to retrieve this information from a map object.

The TiledMapObjectsSample class simply adds code to TiledMapSample. Let's begin with some new members, arrays of sprites for the enemies, items and triggers, the player, a texture atlas, and a Music instance:

private Array<Sprite> enemies = new Array<Sprite>();
private Array<Sprite> items = new Array<Sprite>();
private Array<Sprite> triggers = new Array<Sprite>();
private Sprite player;
private TextureAtlas atlas;
private Music song;

Our create() method calls a private processMapMetadata() function, responsible for querying all the information from the level. We start off by retrieving the music property. Every object that has a set of properties (see the UML diagram in the previous recipe) will offer a getProperties() method. The get() method takes the property key, an optional default value, and the class of the value referenced by the key. The level song will serve as an example:

String songPath = map.getProperties().get("music", String.class);
song = Gdx.audio.newMusic(Gdx.files.internal(songPath));
song.setLooping(true);
song.play();

See the complete MapProperties class reference at http://libgdx.badlogicgames.com/nightlies/docs/api/com/badlogic/gdx/maps/MapProperties.html for more details and also how to add, remove, or modify the existing properties.

From a map, we can get a MapLayers object using getLayers() and then get individual layers by index or name with get(). We can even get all the layers of a given class with the getByType() method passing in the desired class. It is possible to iterate over all the layers using iterator() or a combination of getCount() and get(). You can find the full documentation at http://libgdx.badlogicgames.com/nightlies/docs/api/com/badlogic/gdx/maps/MapLayers.html.

Once we have a layer, we can retrieve its name, properties, opacity, visibility, and collection of objects. You can learn more about MapLayer at http://libgdx.badlogicgames.com/nightlies/docs/api/com/badlogic/gdx/maps/MapLayer.html

In our case, we want to get the list of objects contained in the objects layer:

MapObjects objects = map.getLayers().get("objects").getObjects();

The next step is to iterate over all the objects in the layer. Since our naming convention involved using . to separate between entity type and subtype (for example, item and coin), we need to split the name string. All our objects were rectangles, so we cast them to RectangleMapObject and retrieve the internal rectangle. Be careful because this code will crash if you bump into a nonrectangular object. Refer to the objects' documentation at http://libgdx.badlogicgames.com/nightlies/docs/api/com/badlogic/gdx/maps/objects/package-frame.html for more information.

Depending on the object name, we will create a sprite with a different region and add it to its corresponding collection. Note that we place the sprite at the (x, y) coordinates pointed by the object:

for (MapObject object : objects) {
   String name = object.getName();
   String[] parts = name.split("[.]");
   RectangleMapObject rectangleObject = (RectangleMapObject)object;
   Rectangle rectangle = rectangleObject.getRectangle();
   
   if (name.equals("enemy")) {
      Sprite enemy = new Sprite(atlas.findRegion("enemy"));
      enemy.setPosition(rectangle.x, rectangle.y);
      enemies.add(enemy);
   }
   else if (name.equals("player")) {
      player = new Sprite(atlas.findRegion("player"));
      player.setPosition(rectangle.x, rectangle.y);
   }
   else if (parts.length > 1 && parts[0].equals("item")) {
      Sprite item = new Sprite(atlas.findRegion(parts[1]));
      item.setPosition(rectangle.x, rectangle.y);
      items.add(item);
   }
   else if (parts.length > 0 && parts[0].equals("trigger")) {
      Sprite trigger = new Sprite(atlas.findRegion("pixel"));
      trigger.setColor(1.0f, 1.0f, 1.0f, 0.5f);
      trigger.setScale(rectangle.width, rectangle.height);
      trigger.setPosition(rectangle.x - rectangle.width * 0.5f, rectangle.y + rectangle.height * 0.5f);
      triggers.add(trigger);
   }
}

Fantastic! Now you are able to define your game entities inside an editor and instantiate them at run time. It will be extremely easy to change their location, properties, and so on.