Docs/Contributing Places

Contributing Places

StudyMap is open-source and community-maintained. Add a missing location or fix stale data with a GitHub issue or a pull request.

StudentSuite Team · 2026-08-22 · 3 min read

This page covers the public map, which every visitor sees. If you just want to save a place for yourself instead, sign in and use "My places" on the map - those are private to your account and never go through this review process.

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 (any city worldwide is welcome; SAT and foreign language centres already span several countries, other categories currently have the most coverage in India)
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

Fork the StudyMap repo, clone it locally.
Open data/places/<type>.json for the relevant place type.
Append a new object at the end of the array, following the schema below.
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).

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.
Add each centre to data/places/sat_centre.json with type set to sat_centre, plus exam: "SAT" and a valid_till date.
Use the real city name and coordinates from Google Maps. Centres outside India are welcome and expected here.

Ready to use what you just read?

Open the map Check the calendar