Layar Developer Documentation

Back to

API v8.3 Changes

NOTE: These are the changes in Developer API v8.3. It is supported in Layar client v8.3 (and above) on both Android and iPhone.

In Layar API v8.3 we introduced the following features:

Reference image linking

You can use this feature for two purposes: 

In order to specify additional linked reference images, just add a referenceImages array at the top level of the getPOI response, next to the hotspots array. Detailed description of the referenceImages array can be found here

Material Overrides

Until introducing the v8.3 API the look and feel of 3D models is completely embedded in the 3D file format. This included material colors and texture images. Using material overrides is now possible to customise the look and feel of a model, e.g. the color of a car, without the need to make different copies of the model. This is makes the whole experience more efficient as the client would not have to download all the different versions.

Also note that now we support two new content types for texture which is video/mp4 and image/gif 

 A Json response example can be seen bellow. For more details information not eh API changes check out the updated object parameter.

   "object": {
                "url": "",
                "override": {
                    "materials": [
                            "opacity": 1.0,
                            "ambientColor": "#000000",
                            "diffuseColor": "#660000",
                            "shininess": 50,
                            "materialId": "paint",
                            "specularColor": "#7f7f7f"
                "contentType": "model/vnd.layar.l3d",
                "size": 0.62765415012836456

POI Anchors

This feature allows you to attache one POI to another. This can be particularly handy in case of 3D models. If for example you would like to have a door open on a 3D car, you can break your  3D mode in two and use POI anchors to place them in your scene. 


            "anchor": { "poi": car  },

User location Anchor

The geo POI anchor element has been extended in  order to support POIs tied to the users location. This feature is useful in case of experience domes. 


{ "geolocation": "user" }

Non-uniform scale

We now allow a nonuniform scale in the transform specification. This is represented as a dictionary with the scales factors for the "x", "y" and "z" axis.


"scale":{ "x": 2.0, "y": 1.0, "z": 3.0 }