Place icons

You can request icon URLs, and the corresponding icon background color, with Find Place, Place Details, Nearby Search, and Text Search requests. Icons are available in either PNG or SVG format, and can be used inline.

Fields

Each Place icon contains these fields:

  • icon returns the URL for a 71px PNG icon.
  • icon_mask_base_uri returns the icon URL, minus the .svg or .png extension.
  • icon_background_color returns the default HEX color code for the place's category.

Place icon and background color requests

Request a Place icon and its background color as part of a Find Place, Place Details, Nearby Search or Text Search request. The following examples show an example Find Place request including the icon_mask_base_uri and icon_background_color fields:

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

Example response

The following example shows how the icon_mask_base_uri and icon_background_color fields appear in a response from a Find Place request. To use the URL, append the desired file type extension (.png or .svg).

JSON
{
   "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"
}
      
XML
<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>
      

Place icon examples

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

Place category: Food and drink
(icon background color #FF9E67)
Bar
Bar,
Night club
Cafe
Cafe
Restaurant
Restaurant, Bakery
Place category: Retail
(icon background color #4B96F3)
Bookstore
Books, Clothing, Electronics, Jewelry, Shoes,
Shopping center/Mall
Convenience store
Convenience store
Grocery
Grocery, Supermarket
Pharmacy
Pharmacy
Place category: Services
(icon background color #909CE1)
ATM
ATM
Bank
Bank
Gas
Gas
Lodging
Lodging
Post office
Post office
Place category: Entertainment
(icon background color #13B5C7)
Aquarium, Tourist
Aquarium, Tourist
Golf
Golf
Historic
Historic
Movie
Movie
Museum
Museum
Theater
Theater
Place category: Transportation
(icon background color #10BDFF)
Airport
Airport
Bus
Bus, rideshare, taxi
Train/Rail
Train/Rail
Place category: Municipal/generic/religious
(icon background color #7B9EB0)
Cemetery
Cemetery
Civic building
Civic building
Library
Library
Monument
Monument
Parking
Parking
School (primary, secondary, university)
School (primary, secondary, university)
Worship (Buddhist)
Worship (Buddhist)
Worship (Christian)
Worship (Christian)
Worship (Hindu)
Worship (Hindu)
Worship (Islam)
Worship (Islam)
Worship (Jain)
Worship (Jain)
Worship (Jewish)
Worship (Jewish)
Worship (Sikh)
Worship (Sikh)
Generic business
Generic business
Place category: Outdoor
(icon background color #4DB546)
Boating
Boating
Camping
Camping
Park
Park
Stadium
Stadium
Zoo
Zoo
Place category: Emergency
(icon background color #F88181)
Hospital
Hospital
Police
Police