GuidesAPI Reference
Guides

buildings

Content: default
Geometry: point, polygon
Zoom: 14–17

The following figure illustrates an example of buildings rendered from the data.

Example of Buildings in San Francisco

This layer includes polygons that represent building footprints, building labels placement points, building_part features, and address points. Important buildings appear at zoom level 14 and higher, all other buildings with simplified geometries appear on zoom level 15 and higher. All address points appear at zoom level 14 and higher. The following properties are used to define a building.

📘

Note

Building geometries, like most geometries, are clipped to the bounds of the tile, even if the building extends beyond the tile. This means that it might be necessary to assemble a geometry from several neighboring tiles to recreate a full building. Some buildings are exceptionally large and span many tiles, which can make rendering complex.

Properties

kind | kind_detail | addr_housenumber | has_landmark | height | min_height | layer | name | name:{language_code} | translit:{language_code}

Common properties

sort_rank

Common properties specific to Japan - core map

source


kind

Type: string
Always present

Features are either an address, building footprint or building name.

ValueGeometryDescription
addresspointA label placement point for an address, containing the addr_housenumber property.
buildingpoint, polygonA polygon representing a building footprint or a point representing a building name.
building_partpolygonA polygon representing a part of a building, which may have different height and min_height properties.

kind_detail

Type: string
Present when kind is: building, building_part

The type of building.

Values

ValueDescription
airportA facility that provides a designated area for the landing and takeoff of aircraft and the dispensing and loading of aircraft contents and passengers.
bankA business that specializes in the maintenance, lending, exchange, or issue of money for its customers (for example, central banks, consumer banks, credit unions).
barA nightlife or entertainment business that sells alcoholic beverages and may serve food or light meals.
booksA retail business that primarily sells books.
bridgeA bridge building.
bus_stationA public transport facility that provides a hub in the intercity bus service network.
carA business that sells cars.
car_rentalA business that provides automobiles to rent for short periods of time for a fee.
car_repairA business that provides automotive services, usually a major chain, for the repair or maintenance of a motor vehicle.
casinoA gaming business that provides any variety of legal gambling.
churchA religious place of worship for those of the Christian faith.
cinemaA business that provides a place for showing movies to a large audience.
civicA government building that provides space to the public for community events, special events, seasonal programs, organized classes, as well as a general space for rent.
clothesA retail business that sells general apparel, garments, and/or fashion accessories for men, women, and children.
commercialBusiness or commerce buildings: bank, business facility, hotel, or motel.
convenienceA retail business that sells a combination of food and other products, and may or may not also sell fuel.
courthouseA government building where a court of law is held.
department_storeA retail business that sells a wide variety of merchandise and is organized into various departments for sales and administrative purposes.
educational_institutionUniversity, college, or school buildings.
electronicsA business that sells consumer electronics and electronic entertainment equipment.
embassyA government building that houses diplomatic representatives of foreign countries.
factoryA factory building.
ferry_terminalA public transport facility serving as a hub for ferry services.
fire_stationEmergency services.
fuelA business that sells fuel, oil, and other motoring supplies for drivers of automotive vehicles.
golf_courseA sports and leisure facility used for the game of golf.
governmentPost offices, embassies, city halls, courts, government offices, or county councils.
groceryA retail business that sells a large variety of different types of food, including fresh produce, packaged goods, bakery items, and meat products.
historicalHistorical monuments.
hospitalMedical service or hospital buildings.
hotelA business that provides overnight lodging to the public and usually provides meals, entertainment, and various personal services.
industrialBuildings where some industrial processes take place.
landmarkBuildings that are relevant landmarks, used for navigation, recognizable for users, and often visible from long distances.
libraryA place in which literary, musical, artistic, or reference materials are kept for use and circulation, but are not for sale.
mallA complex of businesses, such as retail stores and restaurants, grouped together and sharing common services.
marinaA facility that provides a dock or basin with moorings and supplies for yachts, small boats, or pleasure crafts.
mixed_useBuildings with a combination of residential, commercial, cultural, institutional, or industrial purposes.
mosqueA religious place of worship for those of the Islamic faith.
museumA business with the primary function of the preservation and exhibition of artistic, historical, or scientific objects.
nightclubA nightlife or entertainment business that provides evening entertainment generally until the very early morning (for example, dance club, lounge, or wine bar).
officeA facility that contains business offices.
parkParks or leisure buildings: bar, pub, casino, park area, or golf course.
parkingBuildings constructed primarily for the purpose of parking cars, which can be single-storey or multi-storey.
pharmacyA retail business that sells prescription and non-prescription medications in addition to other general health remedies.
policePolice stations.
post_officeA business that processes and transmits the mail for a specific area; this can include a local branch or a national office.
religionBuildings built as places of worship: church, mosque, temple, synagogue, ashram, or gurdwara.
residentialBuildings used primarily for residential purposes.
restaurantA business that sells refreshments and prepared meals and may provide seating and/or pickup/takeout services.
retailBuildings used primarily for selling goods to the general public.
schoolAn institution that provides basic elementary or secondary education to children and teenagers.
skiA business that sells skiing-related items, such as skis, ski boots, clothing, and other accessories.
sportsSports center or activity buildings.
synagogueA religious place of worship for those of the Jewish faith.
templeA religious place of worship that may be dedicated to, but is not limited to, Hinduism, Buddhism, Taoism, Sikh, Jain, Ayyavazhi.
theatreA business that presents performing arts.
theme_parkAn entertainment venue with themed rides, attractions, and shows.
tourismTourist attractions or tourist offices.
townhallA government building that houses the seat of an incorporated government for a municipality, city, borough, town, and other administrative unit.
tradeFacilities used for large events such as trade shows, trade fairs, or conventions.
train_stationA public transport facility that provides a hub for passengers and goods travelling between minor and major cities along the railway network.
transportationBuildings used for public transportation.
universityA university building.
wineryA landmark or attraction business that makes wine and may provide tours or wine tastings, which are open to the public.

Values specific to Japan - core map

ValueDescription
inclined_rail_stationA public transport facility that provides a hub for passengers travelling along an inclined cable-guided railway.
monorail_stationA public transport facility that provides a hub for passengers travelling along an elevated monorail railway.
passagewayA horizontal walkway.
staircaseA facility for pedestrian movement.
toll_boothA public transport feature that represents the structure along an expressway or thoroughfare where an automobile must pay a fee in exchange for usage of the roadway.

addr_housenumber

Type: string
Present when kind is: address

A string value of the building number.


has_landmark

Type: flag
Present when kind is: building, building_part

true only if the building or a part of the building is available in the 3D Landmarks layer on the HERE platform. There is no false value, as the property is not present in that case.


height

Type: float
Present when kind is: building, building_part

Elevation of the roof above the ground. Indicated in meters with one decimal point, where available.

Example values: 4.3, 6.1, 8.4, 107.1, 101.0


min_height

Type: float
Optional

Elevation of the building's bottom above the ground if the bottom level of the building or its part is not located on the ground. Indicated in meters with one decimal point, where available.

Example values: 12.5, 17.6, 5.9, 6.9, 6.4


layer

Type: int
Present when kind is: building, building_part

This property indicates vertical ordering.

Value
0

name

Type: string
Present when kind is: building, building_part

The common local name for the building feature, in the local language script. For more information, see Feature names.


Type: string
Present when kind is: building, building_part

The name of the feature in the specified language. If no data is available for the requested language code, the value may be compiled from an English or Latin transliteration of existing language representations. For more information, see Name localization.


translit:{language_code}

Type: string
Present when kind is: building

The localized transliteration of the default name (name). For more information, see Name localization.

Common properties


sort_rank

Type: int
Optional

The ordering of features, which determines which features are rendered "on top of" other features, can be an important issue when rendering maps. To assist map rendering, there is a sort_rank property on some features that suggests in what order the features should appear.

A feature with a higher sort_rank value is displayed on top of feature with a lower sort_rank value.

Value
475

Common properties specific to Japan - core map


source

See source.