Tutorial

Upload you data using our web service.

Using our web interface

After having created your account, you will be able to log in to manage your account.
On the tab “My map”, you will be able to upload your CSV or JSON file. The result will appear after our processing.

Using our web service

Markers can be sent by HTTP using our API with HTTP authentication
Authenticating is done with an authentication token. You will get it on your dashboard when you are logged in.
You have to use this token as login and ‘X’ as password.

URL is to post your file is like this:

http://v2.maptimize.com/api/beta/MAP_KEY/import

MAP_KEY is also available on your dashboard page. You have two keys: one for your production map, one for you development map.
If your plan supports https, you can use https instead of http to use this upload API.

A complete curl command for a CSV file:

curl -u AUTH_TOKEN:X -X PUT http://v2.maptimize.com/api/v2/MAP_KEY/import -T CSV_FILE -H ‘Content-Type: text/csv’

A complete curl command for a JSON file:

curl -u AUTH_TOKEN:X -X PUT http://v2.maptimize.com/api/v2/MAP_KEY/import -T JSON_FILE -H ‘Content-Type: application/javascript’

You can inspect response header ad body (add -v to curl command to get request/response content)

Description Status Response Body
Import succeeded 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<import>
  <status>succeeded</status>
</import>
Import failed because an import is already scheduled or running. 409 Conflict
<?xml version="1.0" encoding="UTF-8"?>
<import>
  <status>failed</status>
  <message>
    an import is already scheduled or running
  </message>
</import>
Import failed because have reached number of uploads per hour or per day according to your plan. 409 Conflict
<?xml version="1.0" encoding="UTF-8"?>
<import>
  <status>failed</status>
  <message>
    next available import in XX mn
  </message>
</import>