Overture Maps API Documentation (1.0)
Download OpenAPI specification:Download
Aden Forshaw: aden@thatapicompany.com URL: https://thatapicompany.com/overture-maps-api
OpenAPI docs for the Overture Maps API
BuildingsController_getBuildings
Authorizations:
API_KEY
query Parameters
lat required | number Example: lat=40.7128 Latitude coordinate. Required if country code is not provided. |
lng required | number Example: lng=-74.006 Longitude coordinate. Required if country code is not provided. |
radius | number >= 1 Default: 1000 Example: radius=1000 Search radius in meters, defaulting to 1000 meters if not provided. |
limit | number >= 1 Default: 1000 Example: limit=10 Limit on the number of results returned, defaulting to 1000 if not provided. |
format | string Default: "json" Enum: "json" "csv" "geojson" Example: format=json Response format, defaulting to JSON. Options are "json", "csv", or "geojson". |
includes | Array of strings Example: includes=id&includes=geometry&includes=properties Array of fields to include in the properties field of the response, provided as a comma-separated string. Any fields not in the list will be excluded from the properties object. This is used to make the response lighter so your application is faster. |
Responses
Get Places using Query params as filters
Authorizations:
API_KEY
query Parameters
required | object (GetPlacesDto) |
Responses
Response samples
- 200
Content type
application/json
[- {
- "id": "12345",
- "type": "Point of Interest",
- "geometry": {
- "type": "Point",
- "coordinates": [
- 40.7128,
- -74.006
]
}, - "properties": {
- "categories": {
- "primary": "Retail"
}, - "confidence": 0.8,
- "websites": [
- "string"
], - "emails": [
- "string"
], - "socials": [
- "string"
], - "phones": [
- "string"
], - "brand": {
- "names": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}
}, - "addresses": [
- {
- "freeform": "123 Main St, Springfield",
- "locality": "Springfield",
- "region": "Illinois",
- "country": "United States"
}
], - "theme": "Restaurant",
- "type": "Commercial",
- "version": "1",
- "sources": [
- {
- "property": "OpenStreetMap",
- "dataset": "OSM",
- "record_id": "osm12345"
}
], - "names": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}, - "ext_name": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}
}
}
]
Get Places with their Building shapes using Query params as filters
Authorizations:
API_KEY
query Parameters
required | object (GetPlacesWithBuildingsDto) |
Responses
Response samples
- 200
Content type
application/json
[- {
- "id": "12345",
- "type": "Point of Interest",
- "geometry": {
- "type": "Point",
- "coordinates": [
- 40.7128,
- -74.006
]
}, - "properties": {
- "categories": {
- "primary": "Retail"
}, - "confidence": 0.8,
- "websites": [
- "string"
], - "emails": [
- "string"
], - "socials": [
- "string"
], - "phones": [
- "string"
], - "brand": {
- "names": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}
}, - "addresses": [
- {
- "freeform": "123 Main St, Springfield",
- "locality": "Springfield",
- "region": "Illinois",
- "country": "United States"
}
], - "theme": "Restaurant",
- "type": "Commercial",
- "version": "1",
- "sources": [
- {
- "property": "OpenStreetMap",
- "dataset": "OSM",
- "record_id": "osm12345"
}
], - "names": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}, - "ext_name": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}
}
}
]
Get all Brands from Places using Query params as filters
Authorizations:
API_KEY
query Parameters
required | object (GetBrandsDto) |
Responses
Response samples
- 200
Content type
application/json
[- {
- "names": {
- "primary": "Central Park",
- "common": {
- "en": "Central Park",
- "es": "Parque Central"
}, - "rules": [
- {
- "variant": "Abbreviation",
- "value": "CP"
}
]
}
}
]