Details feature specification

The "details" feature contains all the data available about the place, like contact information, wiki references, and others. Furthermore, the geometry object of the feature contains the place geometry if it has one. It's building geometry for buildings, boundaries for parks, and so on.

General properties

Property Data type Description
website string Official website
website_other string[] Other websites
website_international map object Websites by country
description string Description
description_international object Description by countries
name string Name
name_other object Other names
name_other.alt_name string Alternative name
name_other.old_name string Outdated name
name_other.official_name string Official name
name_other.short_name string Short name
name_other.loc_name string Local name
name_international object Names by country/language
opening_hours string Opening hours
opening_hours_covid19 string Opening hours special for covid-19 situation
brand string Brand. Trademarks, the identidy of the a product, service or business
brand_details object Brand details
brand_details.wikidata string Brand wikidata
brand_details.wikipedia string Brand wikipedia
brand_details.website string Brand website
operator string Operator. Company, corporation, or person who is responsible for the object operation.
operator_details object Operator details
operator_details.type string Operator type
operator_details.wikidata string Operator wikidata
operator_details.wikipedia string Operator wikipedia
operator_details.website string Operator website
branch string Branch of a brand or chain
network string System of routes or scope of the route
network_details object Network details
network_details.type string Network type
network_details.guid string Network GUID, usually for public transportation
network_details.wikidata string Network wikidata
network_details.wikipedia string Network wikipedia
network_details.website string Network website
owner string Owner of the place
owner_details object Owner details
owner_details.type string Type of ownership
owner_details.wikidata string Owner wikidata
owner_details.wikipedia string Owner wikipedia,
owner_details.website string Owner website
craft string Place producing or processing goods

Contact information properties

Property Data type Description
contact object Contact information
contact.phone string Main phone number
contact.phone_other string[] Other phone numbers
contact.phone_international object Phone numbers by country
contact.email string Main Email
contact.email_other string[] Other emails
contact.fax string Fax

Facilities properties

Property Data type Description
internet_access boolean If the place provides internet access
internet_access_details object Internet access details
internet_access_details.ssid string Network name
wheelchair boolean If the place is sutable for wheelchairs
wheelchair_details object Wheelchair related information
wheelchair_details.condition string Conditions
wheelchair_details.description string Description
wheelchair_details.description_international string Description by country/language
smoking boolean If smoking permitted
toilets boolean If there are toilets
swimming_pool boolean If there is swimming pool
dogs boolean If dogs permitted
air_conditioning boolean If there is air conditioning
changing_table boolean If there is a changing table for babies
outdoor_seating boolean If there is outdoor seating area
takeaway boolean If takeaway option available
takeaway_covid19 boolean If takeaway option available in covid-19 situation
delivery boolean If delivery available
delivery_covid19 boolean If delivery available in covid-19 situation

Restriction properties

Property Data type Description
restrictions object Contact information
restrictions.min_age string Minimum age for a person to enter the place
restrictions.max_age string Maximum age for a person to enter the place
restrictions.max_speed string Speed limit
restrictions.max_weight string Maximum actual weight
restrictions.max_height string Maximum height in metres
restrictions.max_width string Maximum width in metres
restrictions.max_stay string Maximum allowed time
restrictions.max_length string Maximum length in metres
restrictions.access enum Access type - "private", "customers", "permit", "designated", "permissive"
restrictions.access_details object Access details
restrictions.access_details.unisex boolean
restrictions.access_details.male_only boolean
restrictions.access_details.female_only boolean

Special for a category

Property Data type Description
fuel_options object: key => boolean Available fuel options for Gas station
socket_options object Information about socket types and amounts for Charging stations
payment object: key => boolean Available payment options for services and commercials
Accommodation properties
Property Data type Description
accommodation object Properties related to accommodations
accommodation.stars enum Stars - "1", "2", "3", "4", "5", "6", "7", "1S", "2S", "3S", "4S", "5S", "1.5", "2.5", "3.5", "4.5"
accommodation.rooms string Number of rooms
accommodation.beds string Number of beds
accommodation.reservation enum Reservation information - "required" or "recommended"
Catering properties
Property Data type Description
catering object Properties related to restaurants, bars, cafe
catering.stars enum Stars - "1", "2", "3", "4", "5", "6", "7", "1S", "2S", "3S", "4S", "5S", "1.5", "2.5", `"3.
catering.cuisine string Type of cuisine served
catering.cuisine_international object Type of cuisine served by country/language
catering.diet string Type of diet
catering.capacity string Capacity
catering.reservation enum Reservation information - "required" or "recommended"
Parking properties
Property Data type Description
parking object Properties related to parking
parking.type enum Parking type - "surface", "underground", "multi-storey", "lane", "carports", "rooftop"
parking.fee boolean If there is a fee
parking.access enum Access type - "private", "customers", "permit", "designated", "permissive"
parking.surface string Type of surface
parking.smoothness string Information about smoothness
parking.supervised boolean If supervised
parking.park_and_ride boolean If park and ride
parking.max_height string Max height information
parking.max_stay string Max stay information
parking.level string Level if located in multi-level building
parking.levels string Parking levels
parking.levels_underground string Parking underground levels
parking.capacity string Capacity
parking.capacity_details object Capacity details
Airport properties
Property Data type Description
airport object Properties related to airports
airport.icao string ICAO reference
airport.iata string IATA reference
airport.closest_town string Closest city
Building properties
Property Data type Description
building object Properties related to building
building.type string Building type
building.levels string Levels
building.levels_underground string Underground levels
building.age string Building age
building.type_ruian string RUIAN type of the building. Contains the type of the building from the RUIAN database of properties in the Czech Republic
building.use string Building usage type
building.use_type object: key => boolean Usage by type
building.architecture string Building architecture type
building.shape string Building shape
building.walls string Building walls
building.units string Units
building.flats string Flats
building.material string Material type
building.floor string Floor material type
building.color string Color
building.condition string Condition
building.owner string Building owner
building.start_date string Utilization start date
building.construction_start_date string Construction start date
building.height string Height
building.foundation_height string Foundation height
building.roof object Roof
building.roof.type string Roof type
building.roof.shape string Roof shape
building.roof.height string Roof height
building.roof.color string Roof color
building.roof.orientation string Roof orientation
building.roof.direction string Roof direction
building.roof.levels string Roof levels
Place of worship properties
Property Data type Description
place_of_worship object Properties related to building a place of worship
place_of_worship.religion string Religion
place_of_worship.denomination string Denomination
Commercial properties
Property Data type Description
commercial object Properties related to shops and commercials
commercial.type string Type of commercial
commercial.clothes string Type of clothes
commercial.shoes string Type of shoes
commercial.trade string Description of the merchandise. A place of business that sells to a particular trade or trades.
commercial.sport string Type of sport
commercial.bulk_purchase boolean If selling products without packaging
commercial.organic boolean If selling organic food/products
commercial.fair_trade boolean Whether you can have fair trade food or products
commercial.origin string Country of origin
commercial.level string Level if locates in multi-level building
commercial.indoor boolean If locates indoor
Historic places properties
Property Data type Description
historic object Properties related to historic places
historic.type string Type of historic object
historic.civilization string Describe roughly which civilization (or ancient culture) has built a feature
historic.period string Period
historic.importance string Importance of the object
historic.site_type string A typological system for archaeological sites
historic.start_date string When the object was opened or constructed
historic.end_date string When the object was out of service
historic.military string Type of millitary object
historic.memorial string Type of memorial object
historic.memorial_details object Memorial object details
historic.memorial_details.type string Type of memorial object
historic.memorial_details.name string Name of memorial object
historic.memorial_details.text string Memorial object incription text
historic.inscription string Incription text
historic.ruins boolean If ruins
historic.castle_type string Castle type
historic.bunker_type string Bunker type
historic.megalith_type string Megalith type
historic.fortification_type string Fortification type
historic.artwork_type string Artwork type
historic.tower_type string Tower type
historic.object_type string Object type
Artwork objects properties
Property Data type Description
artwork object Properties related to artworks
artwork.artist_name string Artist name
artwork.artist_details object Artist details
artwork.artist_details.wikidata string Artist wikidata
artwork.artist_details.wikipedia string Artist wikipedia page
artwork.artist_details.website string Artist website
artwork.artwork_type string Type of artwork
artwork.artwork_subject string Artwork object subject
artwork.start_date string When the object was opened or constructed
artwork.end_date string When the object was out of service
Heritage objects properties
Property Data type Description
heritage object Properties related to heritage objects
heritage.operator string Heritage operator
heritage.website string Heritage website
heritage.ref string Heritage reference
heritage.description string Heritage description
inscription_date string Date when the object was added to the preservation list

Wiki and media properties

Property Description
wiki_and_media object
wiki_and_media.wikidata Wikidata reference
wiki_and_media.wikipedia Wikipedia reference
wiki_and_media.wikimedia_commons Wikimedia reference
wiki_and_media.image Image url

Address properties

If the place has an address the feature properties contains address components as well:

Property Description
name Location name
country Country component of an address
state State component of an address
postcode Postcode or ZIP code of an address
city City component of an address
street Street component of an address
housenumber House number component of an address
lat, lon Coordinates of the location
formatted Display address
address_line1 Main part of the display address, contains building street and house number or amenity name
address_line2 The second part of the display address, contains address parts not included to address_line1

Note! The data returned by the API only if it's present in the OpenStreetMap database. We provide the data as it is after some cleanup and formating. All the data of the OSM database is added by OSM contributors and some parts of it might be incorrect or outdated.

Place feature specification

By default, the place feature is Point type feature with properties containing address information and place categories. The Place feature can contain Polygon / Multipolygon geometry when specified for Place Details API and Boundaries API results.

Name Description
name Location name
country Country component of an address
state State component of an address
postcode Postcode or ZIP code of an address
city City component of an address
street Street component of an address
housenumber House number component of an address
lat, lon Coordinates of the location
formatted Display address
address_line1 Main part of the display address, contains building street and house number or amenity name
address_line2 The second part of the display address, contains address parts not included to address_line1
categories All categories, that the places belongs to. Can take values of supported categories and supported conditions
place_id Unique identifier for the place, that can be used to extract additional information about the place with Place Details API and Boundaries API

Geometry feature specification

The following properties are common for Geometry Features

Name Description
lat, lon Coordinates of the location
type Type of the geometry - "radius", "time", "distance"
range Range in seconds or meters
mode Mode for isochrones - "drive", "truck", "transit", "approximated_transit", "walk", "bicycle".