Howloud (1.0.0)

Download OpenAPI specification:Download

Introduction

The howloud API offers map tiles and soundscores.

Authentication

header-api-key

Required API Key

Security Scheme Type API Key
Header parameter name: x-api-key

query-api-key

Required API Key

Security Scheme Type API Key
Query parameter name: x-api-key

Retrieves a soundscore for the given address

query Parameters
address
required
string
Example: address=2282 W Camino Alto St, Springfield, MO 65810

the address for which the soundscore should be retrieved.

Responses

Request samples

params = {'address': '2282 W Camino Alto St, Springfield, MO 65810' }
url = 'https://api.howloud.com/address'
headers = {'x-api-key': '<YOUR API KEY>'}
r = requests.get(url, params=params, headers=headers)
json = r.json()
print(r['result']['score'])

Response samples

Content type
application/json
{
  • "status": "OK",
  • "request": {
    },
  • "result": {
    }
}

Retrieves a soundscore for the given latitude and longitude

query Parameters
lat
number
Example: lat=37.13397

latitude

lng
number
Example: lng=-93.32604

longitude

Responses

Request samples

params = { 'lng': '-93.3', 'lat': '37.12' }
url = 'https://api.howloud.com/score'
headers = {'x-api-key': '<YOUR API KEY>'}
r = requests.get(url, params=params, headers=headers)
json = r.json()
print(r['result']['score'])

Response samples

Content type
application/json
{
  • "status": "OK",
  • "request": {
    },
  • "result": {
    }
}

Retrieves tiles for the given type, latitude, longitude and zoom level (WGS84/EPSG:3857)

path Parameters
type
required
string
Enum: "airports" "local" "score" "traffic"
Example: airports

type of tile to retrieve

z
required
integer
Example: 14

z coordinate of the tile (wgs84)

x
required
integer
Example: 2622

x coordinate of the tile (wgs84)

y
required
integer
Example: 5719

y coordinate of the tile (wgs84)

Responses

Request samples

url = 'https://api.howloud.com/tiles/airports/0/0/0.png'
headers = {'x-api-key': '<YOUR API KEY>'}
r = requests.get(url, params=params, headers=headers)

Retrieves soundscore heatmap, an html map showing soundscore heatmap tiles. Requires trailing slash.

Responses

Request samples

https://api.howloud.com/map/?x-api-key=<YOUR API KEY>

Retrieves soundscore coverage, an html map showing soundscore coverage. Requires trailing slash.

Responses

Request samples

https://api.howloud.com/coverage/?x-api-key=<YOUR API KEY>