Find The Best Sports Places in Your Area (1/2)

heri
Decathlon Digital
Published in
3 min readJan 7, 2020

As the largest sporting goods retailer in the world, Decathlon holds an extensive database of local sports places. This is a treasure chest for coaches, clubs, sports companies and of course for sports fans. Decathlon now makes it available to developers in its mission to make sports accessible.

With one API call, get the list of ski locations near Montreal, Canada:

Click “run” to see the locations on the map

That’s it! No registration required.

Sports Places API works with 707 sports. If you are doing a healthcare, well-being or sports app, you can immediately onboard users with sports suggestions in their area.

We do not have all the local sports places. But we have about 15k places in Canada, Europe, Hong-Kong and developers can add sports places once registered.

Decathlon itself uses the Sports Places API to power community. It’s the go-to place to discover new sports and activities in your local area. Every week, there are always free activities such as running or fitness, as well as more advanced topics such as sports nutrition.

You can join, learn a new sport, meet new people, and pick up healthy habits. What more to ask?

I will show you how straightforward it is to customize the request for your use case.

Reverse Geocode a Location

First, Sports Places API requires a set of geographic coordinates. We can use Open Cage to reverse geocode a location.

For a mobile application, you can get the coordinates through the device’s GPS.

Get a Sport Id

We also need a sport id to use the sports places API. Decathlon provides an endpoint to get this information:

It is also possible to list all sports in the database, and then filter results with the name.

Get the List of Places

We can use the sport id and the set of geo coordinates found previously.

Altogether, we get the following:

Click “run” to see hiking places near Montreal. Or change city and sport to your preferences

As you can see, it’s dead easy to get sport activities for any given location and sport. And it’s just getting started! Decathlon has a diverse team in back-end, artificial intelligence and front-end working to make these as the sports API of choice, from hackathons to serious projects.

Developers can use these results as a starting point, and are welcomed to enrich them with user reviews, user-generated pictures, annotations or local translations. If you have a request or want to discuss, make sure to be in touch developers@decathlon.com

We hope this post gets you started! Next, our next article sees how to add places and activities and corresponding translations.

Decathlon Developers hiring

If you are looking for a tech job and an opportunity to make sports more accessible, check out our careers section on https://developers.decathlon.com/careers

--

--