Place Icons

Page Summary

outlined_flag

• Place icons, available in PNG or SVG formats, visually represent various place types like restaurants and libraries, and can be requested using Find Place, Place Details, Nearby Search, and Text Search requests.

• Each icon is identified by an icon base URI (requiring .svg or .png appended for the full URL) and an icon background color, represented by a HEX color code.

• While the older Places API uses icon , icon_mask_base_uri , and icon_background_color fields, the new Places API uses iconMaskBaseUri and iconBackgroundColor .

• To display an icon, combine the icon base URI with the desired file type extension and apply the icon background color as the background of the image element.

• Place icons are categorized, such as Food and drink or Tourist, with each category having a specific background color.

Introduction

Place icons indicate the various types of places (for example coffee shops, libraries, and museums). You can request URLs for icons in PNG or SVG format, as well as the corresponding icon background color, with Find Place, Place Details, Nearby Search, and Text Search requests. Icons can be used inline.

Each icon is defined by two response fields:

• The icon base URIcontains the base URL for a non-colored icon, minus the file type extension. You must append .svg or .png to the URI to request the icon.
• The icon background colorcontains the default HEX color code for the place's category.

Example

The following examples show how to request an icon URI and background color for Places API (New) and Places API (Legacy). Notice that the request and responses are different for the two versions of the API.

curl -X POST -d '{
  "textQuery" : "skog haus",
  "maxResultCount" : 1
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY 
' \
-H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \
'https://places.googleapis.com/v1/places:searchText'

 { 
  
 "places" 
 : 
  
 [ 
  
 { 
  
 "iconMaskBaseUri" 
 : 
  
 "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet" 
 , 
  
 "iconBackgroundColor" 
 : 
  
 "#FF9E67" 
 , 
  
 "displayName" 
 : 
  
 { 
  
 "text" 
 : 
  
 "SKÖG Haus Coffee & Tea" 
 , 
  
 "languageCode" 
 : 
  
 "en" 
  
 } 
  
 } 
  
 ] 
 } 

  
 https 
 : 
 //maps.googleapis.com/maps/api/place/findplacefromtext/json?input=skog%20haus&inputtype=textquery&fields=name,icon_mask_base_uri,icon_background_color&key= API_KEY 
 

  
 { 
  
 "candidates" 
  
 : 
  
 [ 
  
 { 
  
 "icon_background_color" 
  
 : 
  
 "#FF9E67" 
 , 
  
 "icon_mask_base_uri" 
  
 : 
  
 "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet" 
 , 
  
 "name" 
  
 : 
  
 "SKÖG Haus Coffee" 
 , 
  
 } 
  
 ], 
  
 "status" 
  
 : 
  
 "OK" 
  
 } 
  

  
<FindPlaceFromTextResponse>  
<candidates>  
<name>SKÖG  
Haus  
Coffee</name>  
<icon_background_color>#FF9E67</icon_background_color>  
<icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet</icon_mask_base_uri>  
</candidates>  
<status>OK</status>  
</FindPlaceFromTextResponse>  

To display an icon, append the file type extension (.png or .svg) you want to the returned icon URI, and combine the icon with the returned background color. For example, to display the .svg icon on a web page:

<style>
  .icons-food-drink {
    background-color: #ff9e67;
    width: 88px;
    height: 88px;
    padding: 5px;
  }
</style>

<img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>

Place icon and background color requests

The following tables show all of the available place icons by category. By default these display with a black glyph. The icon background color is dictated by the place's category.

Place category: Food and drink
(icon background color #FF9E67)

Bar,
Night club

Cafe

Restaurant, Bakery

Place category: Retail
(icon background color #4B96F3)

Books, Clothing, Electronics, Jewelry, Shoes,
Shopping center/Mall

Convenience store

Grocery, Supermarket

Pharmacy

Place category: Services
(icon background color #909CE1)

ATM

Bank

Gas

Lodging

Post office

Place category: Entertainment
(icon background color #13B5C7)

Aquarium, Tourist

Golf

Historic

Movie

Museum

Theater

Place category: Transportation
(icon background color #10BDFF)

Airport

Bus, rideshare, taxi

Train/Rail

Place category: Municipal/generic/religious
(icon background color #7B9EB0)

Cemetery

Civic building

Library

Monument

Parking

School (primary, secondary, university)

Worship (Christian)

Worship (Hindu)

Worship (Islam)

Worship (Jain)

Worship (Jewish)

Worship (Sikh)

Generic business

Place category: Outdoor
(icon background color #4DB546)

Boating

Camping

Park

Stadium

Zoo

Place category: Emergency
(icon background color #F88181)

Hospital

Police