diff --git a/README.md b/README.md
index 2821da806bcb94527ec862226b913e4cf7b94b68..5b150ccb596a31017cd7b519ba7bf28f83dd2cd2 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,8 @@ If you move the camera, it calculates again orientation and position. If places
 
 Learn more with [this article](https://medium.com/@nicolcarpignoli/location-based-gps-augmented-reality-on-the-web-7a540c515b3c).
 
+For Location Based Documentation, refer [here](https://github.com/jeromeetienne/AR.js/blob/location-based/aframe/README.md).
+
 🌍Click on the examples below to try it out.  
 📲Open from mobile phone with GPS data enabled.
 
@@ -89,6 +91,12 @@ Learn more with [this article](https://medium.com/@nicolcarpignoli/location-base
     Show icon and place name above. Clicking on places will redirect to a certain URL (now mocked up).
 
   <img height="569" width="320" src="https://github.com/nicolocarpignoli/GeoAR.js/blob/master/docs/places-name.gif?raw=true">
+  
+Every example uses the `places.js` script to load places. You set your places using static data, with specific coordinates, adding these info in the first lines of code (there are comments to explain it better).
+
+Otherwise, as default, the script searches for places of interest near the user using Foursquare APIs. Please retrieve valid API credentials [here](https://developer.foursquare.com/) in order to use it. Place credentials (replace both Client Secret and Client Id) on `places.js`.
+
+You can also use GeoAR.js **without** the script, adding `gps-entity-place` entities them directly on the `index.html` file.as documentated [here](https://github.com/jeromeetienne/AR.js/blob/location-based/aframe/README.md).
 
 
 # Index