Place Icons

AI-generated Key Takeaways

• Place icons, available in PNG format, represent various place types like restaurants and libraries, accessible through Current Place and Place Details requests.

• You can retrieve the icon URL using Place.Field.ICON_MASK_URL and the background color using Place.Field.ICON_BACKGROUND_COLOR.

• The icon URL is a base URL for a non-colored PNG that is overlaid on a background color representing the place's category, like #FF9E67 for food and drink.

• Code examples are provided in Kotlin and Java to demonstrate fetching and displaying the icon and background color using an image loading library like Glide.

• A comprehensive table showcases available place icons categorized by type, along with their corresponding background colors.

Select platform: Android iOS JavaScript Web Service

Place icons indicate the various types of places (for example coffee shops, libraries, and museums). You can request URLs for icons in PNG format, as well as the corresponding icon background color, with Current Place, and Place Details (New) requests.

To request an icon image and background color for a place, include the following fields in your request:

• Place.Field.ICON_MASK_URL
• Place.Field.ICON_BACKGROUND_COLOR

The following examples demonstrate using the icon image and background color from a Current Place or Place Details request:

Kotlin

    // Set the image view's background color to match the place's icon background color
    imageView.setBackgroundColor(place.iconBackgroundColor)

    // Fetch the icon using Glide and set the result in the image view
    Glide.with(this)
        .load(place.iconUrl)
        .into(imageView)

      

Java

    // Set the image view's background color to match the place's icon background color
    imageView.setBackgroundColor(place.getIconBackgroundColor());

    // Fetch the icon using Glide and set the result in the image view
    Glide.with(this)
        .load(place.getIconUrl())
        .into(imageView);

      

This example uses the Glide image loading library, but you can use the image loading library of your choice.

Icon URLs may change, so be sure to always use Place.Field.ICON_MASK_URL to look up the URL for an icon.

Fields

Each Place icon contains these fields:

• ICON_MASK_URL returns the base URL for a non-colored PNG icon.
• ICON_BACKGROUND_COLOR returns the default 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