Mapillary for Organizations enables organizations to host the contributions of many teammates in one spot. By creating an organization account, you'll be able to view, filter, and download your team's imagery in a centralized place, as opposed to working with disjointed coverage across multiple individual Mapillary accounts.
With Mapillary for Organizations, you can:
- Contribute street-level imagery owned by your organization
- Assign different permissions roles to team members
- Download your data as a GeoJSON to use in external tools or a GIS
- Use the Mapillary API or Mapillary Python SDK to query your imagery, explore its metadata, and integrate it into your workflows
- Use MapillaryJS to build a custom app to analyze and view your organization's imagery
Everything you'll need to know about getting started with Mapillary for Organizations is detailed below.
📖Table of Contents
- Creating an organization account
- Your organization dashboard
- Adding teammates and assigning roles
- Uploading to an organization account
- Viewing organizational imagery
- Downloading organizational imagery and map data
- Further reading & questions
🏘️ Creating an organization account
First things first, you'll need to create an individual account on Mapillary to create an organization.
Next, log into the Mapillary web app on your computer. All organization account management must be done through our web app.
Once you've made it to the web app, click on your username in the top right corner of the screen to expand the account pane. Click again on your username—here you'll see a dropdown with the option to add a new organization.
When you click on 'New organization,' a pop-up will open. Creating an organization is as simple as typing in a name. Be mindful that certain characters, like punctuation or emojis, are not compatible.
As you type, you'll notice that the url subdirectory for your organization auto-populates. You can click the 'Edit' button to modify this default if you wish.
🖥️Your organization dashboard
When you click 'Create,' you'll be auto-directed to the new dashboard for your organization.
Your organization dashboard is where you can edit your organization's profile and add new team members.
We suggest changing your profile picture to a logo from your group. You can also add a bio to make it known what your goals with Mapillary are!
If you need to change your organization's display name, you are welcome to do so. However, you cannot change your organization username.
Another important thing to note is your organization key. This is the unique identifier for your organization that you'll need to use if using the Mapillary API or other Mapillary developer tools.
👩🏻🤝👨🏽Adding team members and assigning roles
Adding members
Click on the 'Team' setting on the left pane on your organization profile to manage your teammates. Here you'll see a list of all of your team members and their roles.
To add new members, click on the 'Add team members' button in the top right corner. A pop-up will open. To add a user, they'll need to have an individual Mapillary account already.
Add users via the search box. You can add multiple people at a time. If you've accidentally added a wrong account, you can click on the 'Contributor' dropdown to remove them from your selection.
Once you've finalized your list of accounts to add, simply click 'Add.' Now they're a part of your organization!
Team roles
There are three roles available on Mapillary for Organizations, Admin, Member, and Contributor. Admins have the most power, then members, then contributors. Their permissions are as follows:
Admin
- View and edit the organization profile and account information
- Add and remove team members and change their roles
- Contribute imagery on behalf of the organization
- View, edit, and delete organization imagery
- Add and delete shapes
- Request and download data dumps
Member
- View the organization profile and account information
- View team members and roles
- Contribute imagery on behalf of the organization
- View and edit organization imagery
- View shapes
- Download data dumps previously requested by an admin
Contributor
- View the organization profile information
- Contribute imagery on behalf of the organization
- View organization imagery
By default, the creator of the organization is the admin. This cannot be changed. When adding new teammates, they'll default contributors. To change a teammates permissions, click on the dropdown next to their role title.
Roles can be changed an infinite number of times. Additionally, you can also delete a member here if you need. Their contributions will remain with the organization.
📸Uploading to an organization account
There are three main avenues to uploading imagery to Mapillary: our mobile apps, the Desktop Uploader, and Mapillary Tools for the command line. Mapillary Tools is an open-sourced Python library, and thus can be consumed in scripts to upload imagery in advanced cases as well.
Mobile apps
To learn how to capture and upload organizational imagery via our mobile apps, see our mobile app guides, specifically the 'Capturing' section.
Desktop Uploader
To learn how to upload imagery to an organization account via the Desktop Uploader, check out our guide on the Desktop Uploader. The Desktop Uploader has an easy-to-use GUI that makes uploading to Mapillary as easy as dragging a folder into the application. Plus, as of Fall 2024, you can now adjust poor GPS image positions!
Mapillary Tools for the command line
Mapillary Tools allows you to upload via the command line. Full documentation is on Github. Optional flags enable you to upload to an organization account; you'll need your organization key mentioned earlier to do so.
🖼️Viewing organizational imagery
You can view your organization's contributions on the Mapillary web app. Switch to your organizational profile, navigate to an area where you've captured, and explore your captures! Toggle on your organization's imagery layer via the account pane to symbolize your organization's captures in blue. Being able to compare your group's coverage again the rest of Mapillary is helpful to learn what areas you may want or need to capture next.
Similarly, if you want to view just your organization's imagery, toggle off the 'All imagery' layer.
Additionally, you can use the traditional Mapillary filters against your organization's imagery as well. You can add a filter for a certain date range, a certain user's contributions, etc.
📬Downloading organizational map data
It is likely that, if you have a Mapillary Organization, that you are interested in using your imagery and the Mapillary CV-generated map data that automatically comes with hosting imagery on Mapillary.
There are a number of ways to download associated Mapillary data for an organization
Downloading map features via the web app
The simplest, and most rigid, is to apply your desired filters in the web app, and then click on the 'Download' button to download a geojson of either traffic signs or point map features.
You'll need to be zoomed into an extent such that map features render to be able to download them.
Unfortunately, there are no direct filters for filtering map features by organizations or username, as map features can be generated/have their predicted positions improved via the imagery of multiple users. However, you can filter map features by date range—this tactic can be used to hone in on the map features most relevant to your organization's captures.
Downloading map features, object detections, and image thumbnails via the Mapillary API
The Mapillary API is a more specialized way to pull the information you need from your organization's imagery. This is a better approach if you're looking to consume the data in any sort of authoritative database—you have the autonomy to dictate what fields (capture date, upload date, camera type, etc.) are returned by the API.
You can also apply advanced filtering against parameters such as a bounding box, camera make, camera model, map feature/object detection class, etc. A workflow consisting of multiple API calls to different endpoints can give you a large deal of autonomy working with Mapillary data.
See the Mapillary API documentation for full details and examples of how you can pull insights from your imagery in bulk.
Downloading Mapillary data via the Mapillary Python SDK
You may also choose to use and download Mapillary data via the Mapillary Python SDK. The Mapillary Python SDK is built off of the Mapillary API and makes it easy to interact with Mapillary data via Python.
📚Further reading & questions
Interested in learning more about how your organization can integrate Mapillary into your workflows? See our article on leveraging Mapillary as an organization.
Additionally, you may be interested to learn more about Mapillary's integration into third party applications such as ArcGIS Pro or OpenStreetMap.
Have any questions? You can reach us by submitting a support ticket.