Attribution

Mapricot's results and map tiles come from open data, and some of the data's licenses require a credit when people see it. This page covers the minimum those licenses require.

The short version:

  • On a map from Mapricot's tiles, keep the OpenStreetMap credit in the map's corner. The styles already show it, so leave it in place.
  • Anywhere else, such as a list of search results, an address on an order page, or a route drawn on a map, an attribution page linked from your site's footer or your app's about screen is enough.
  • If nobody outside your organization sees the data, you don't need to credit it.

What each source requires

Source License Required credit
OpenStreetMap ODbL © OpenStreetMap contributors, linked to its copyright page
OpenAddresses Each government or other source's own open license OpenAddresses
Who's On First A mix of open licenses, listed by source A link to its license page
GeoNames CC BY 4.0 GeoNames, with a link to the license
DB-IP City Lite CC BY 4.0 A link to db-ip.com, and to the license
Overture Maps Places: mostly CDLA Permissive 2.0 None for results

Map tiles and routing use only OpenStreetMap. Geocoding and places use OpenStreetMap, OpenAddresses, Who's On First, GeoNames, and Overture. IP geolocation uses DB-IP. The open-source software behind them, such as Valhalla, Pelias, and Protomaps' tile builds, needs no credit.

Each geocoding, places, and routing response also lists the sources of its results in attribution, with the text and link for each. You don't need it if your attribution page lists every source, but it tells you which sources you use.

On a map

OpenStreetMap's attribution guidelines require the credit on a map built from its data, usually in a corner. It can shrink to an ⓘ button, on a small screen or once someone uses the map, as long as tapping it shows the credit again. Mapricot's styles show "Mapricot © OpenStreetMap" this way.

You don't need to add anything for the results you draw on the map. The attribution page covers them.

MapLibre GL JS

MapLibre shows the style's credit in the corner by default. Don't turn off its attribution control with attributionControl: false.

Leaflet

Leaflet draws Mapricot's tiles through the MapLibre GL Leaflet plugin, which puts the style's credit in Leaflet's attribution control. Keep that control on the map. Geocoding and routing with Leaflet builds a complete map.

iOS and Android

MapLibre Native, on iOS and Android, shows an ⓘ button in the map's corner that lists the style's credit, and so does MapLibre React Native. Leave the button visible.

Outside a map

OpenStreetMap's geocoding guideline requires apps that use a geocoder or a router built on its data to credit it, and CC BY requires a credit wherever the data is shared with people. Neither requires the credit next to the results, and CC BY says a link to a page that holds the attribution can meet it.

So when you show results anywhere but in a Mapricot map's own tiles, such as in search suggestions, a saved delivery address, "20 minutes away", or markers and routes drawn on a map, an attribution page covers them:

  • List the attribution in the table above for the sources you use. Mapricot's own is an example.
  • Link to it from your site's footer, or your app's about or settings screen. DB-IP asks for its link on the pages that show or use its data, which a footer link covers, including when you use an IP location without showing it, such as to fill in a country.

If you share a file or a dataset that includes results, put the attribution and licenses in its readme or metadata instead.

When you don't need to credit

  • Nobody outside your organization sees the data. Internal dashboards, analytics, data cleaning, and testing need no credit. ODbL and CC BY require credit only when the data, or something made from it, is shared publicly.
  • A thumbnail too small to matter. OpenStreetMap's guidelines exempt small static images, such as icons, and maps of fewer than 100 features covering less than 10,000 m².

Storing results

You can keep results for as long as you like and show them later, as the terms say. Your attribution page covers them whenever you show them.

ODbL has one more condition for results from OpenStreetMap. Storing the addresses your customers enter with their coordinates is fine. But if you collect results into a database that holds a large part of OpenStreetMap, such as by geocoding every business in a city to build your own places database, and then share it or use it publicly, ODbL requires you to offer that database under ODbL too. The geocoding guideline explains where the line is.

This page explains the licenses in plain words. It isn't legal advice, and the licenses themselves are what count. If your use doesn't fit any of these cases, ask us.