StudyMap
Back to docs

Contributing Places

StudyMap is open-source and community-maintained. Every place in the database was added by a student. Here is how to add or fix one.

Option A: GitHub Issue (easiest)
No code needed

Open a new GitHub issue with:

  • Place name
  • Full address
  • Type: SAT centre, foreign language exam centre, library, government office (passport office, RTO, post office), airport, or other place
  • City and country (SAT and foreign language centres are listed worldwide; other categories currently focus on the Mumbai region)
  • Google Maps link

A maintainer will add the place, usually within a few days.

Option B: Pull Request
For those comfortable with JSON and Git
  1. Fork the StudyMap repo, clone it locally.
  2. Open data/places/<type>.json for the relevant place type.
  3. Append a new object at the end of the array, following the schema below.
  4. Commit and open a pull request against main.
{ "id": "mum-library-07", "name": "Place Name", "type": "library", "city": "mumbai", "lat": 19.1234, "lng": 72.8765, "address": "Street, Area, City PINCODE", "gmaps_link": "https://maps.google.com/?q=19.1234,72.8765", "added_by": "your-github-username" }

ID format: a short city-code prefix (mum, thn, nvm, blr, and so on), then the type, then the next available number in that file. Coordinates come straight from Google Maps, so there is no fixed range: SAT and foreign language centres span the globe.

Fixing stale data
Place moved, closed, or details changed

Use either option above. For issues, just describe what changed. For a PR, edit the existing entry in the relevant JSON file and update the field.

Full contributing guide on GitHub
Adding SAT centres for a new country
Help expand the map beyond India

We are adding SAT centres country by country. Several countries already have open tracking issues (Germany, France, UK, UAE, Australia, and more).

  1. Check the open country requests. If your country is listed, comment there or open a PR that closes it. If not, open a new issue for it.
  2. Add each centre to data/places/sat_centre.json with type set to sat_centre, plus exam: "SAT" and a valid_till date.
  3. Use the real city name and coordinates from Google Maps. Centres outside India are welcome and expected here.