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.
The following example shows a Find Place request which includes 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>
Fields
Each Place icon contains these fields:
icon
returns the URL for a colored 71px x 71px PNG icon.icon_mask_base_uri
returns the base URL for a non-colored icon, minus the file type extension (append.svg
or.png
).icon_background_color
returns the default HEX color code for the place's category.
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 |