Os ícones de lugar indicam os vários tipos de local (por exemplo, cafés, bibliotecas e museus). Também é possível solicitar URLs para ícones no formato PNG
como a cor de fundo do ícone correspondente, com
Local atual,
e Place Details (novo)
solicitações.
Para solicitar uma imagem de ícone e uma cor de fundo para um local, inclua os
campos a seguir na sua solicitação:
Place.Field.ICON_MASK_URL
Place.Field.ICON_BACKGROUND_COLOR
Os exemplos a seguir demonstram o uso da imagem do ícone e da cor de fundo
de uma solicitação de Current Place ou Place Details:
Kotlin
// Set the image view's background color to match the place's icon background colorimageView.setBackgroundColor(place.iconBackgroundColor)// Fetch the icon using Glide and set the result in the image viewGlide.with(this).load(place.iconUrl).into(imageView)
Java
// Set the image view's background color to match the place's icon background colorimageView.setBackgroundColor(place.getIconBackgroundColor());// Fetch the icon using Glide and set the result in the image viewGlide.with(this).load(place.getIconUrl()).into(imageView);
Este exemplo usa o comando Glide
de carregamento de imagens, mas você pode usar a biblioteca de carregamento de imagens de sua escolha.
Campos
Cada ícone de lugar contém estes campos:
ICON_MASK_URL retorna o URL de base para um ícone PNG sem cor.
ICON_BACKGROUND_COLOR retorna o código de cor padrão para a
categoria do lugar.
Solicitações de ícone de lugar e cor do plano de fundo
As tabelas a seguir mostram todos os ícones de lugar disponíveis por categoria. Por padrão, elas aparecem com um glifo preto. A cor de fundo do ícone é definida pela categoria do lugar.
Categoria do lugar: alimentos e bebidas (cor #FF9E67 do plano de fundo do ícone)
Bar, Clube noturno
Café
Restaurante, padaria
Categoria do lugar: varejo (cor #4B96F3 do plano de fundo do ícone)
Livros, roupas, eletrônicos, joias, sapatos, Shopping Center
Loja de conveniência
Mercearia, supermercado
Farmácia
Categoria do lugar: serviços (cor #909CE1 do plano de fundo do ícone)
Caixa eletrônico
Banco
Postos de gasolina
Hospedagem
Correio
Categoria do lugar: entretenimento (cor #13B5C7 do plano de fundo do ícone)
Aquário, turista
Golfe
Histórico
Filme
Museu
Teatro
Categoria do lugar: transporte (cor #10BDFF do plano de fundo do ícone)
Aeroporto
Ônibus, serviço de transporte por aplicativo, táxi
Trem/Via férrea
Categoria do lugar: municipal/genérico/religioso (cor #7B9EB0 do plano de fundo do ícone)
Cemitério
Construção civil
Biblioteca
Monumento
Estacionamento
Escola (primária, secundária, universidade)
Igreja (cristã)
Templo (hindu)
Mesquita (islâmica)
Templo (jainista)
Templo (judeu)
Templo (siquista)
Empresa genérica
Categoria do lugar: ao ar livre (cor #4DB546 do plano de fundo do ícone)
Barco
Acampamento
Parque
Estádio
Zoológico
Categoria do lugar: emergência (cor #F88181 do plano de fundo do ícone)
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003ePlace icons, available in PNG format, represent various place types like restaurants and libraries, accessible through Current Place and Place Details requests.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the icon URL using \u003ccode\u003ePlace.Field.ICON_MASK_URL\u003c/code\u003e and the background color using \u003ccode\u003ePlace.Field.ICON_BACKGROUND_COLOR\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe 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.\u003c/p\u003e\n"],["\u003cp\u003eCode examples are provided in Kotlin and Java to demonstrate fetching and displaying the icon and background color using an image loading library like Glide.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table showcases available place icons categorized by type, along with their corresponding background colors.\u003c/p\u003e\n"]]],["Place icons, indicating different types of locations, can be accessed via URLs in PNG format along with their background colors. Requests for icons and colors require the `ICON_MASK_URL` and `ICON_BACKGROUND_COLOR` fields. The icon URL, obtained through `Place.Field.ICON_MASK_URL`, should be consistently referenced due to potential changes. `ICON_BACKGROUND_COLOR` returns the category's default color. The document then details various place categories and their associated icons and background colors. For example food and drink has the background color #FF9E67.\n"],null,["# Place Icons\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/icons \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/icons \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place-icons \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/icons \"View this page for the Web Service platform docs.\")\n\nPlace icons indicate the various types of places (for example coffee shops,\nlibraries, and museums). You can request URLs for icons in PNG format, as well\nas the corresponding icon background color, with\n[Current Place](/maps/documentation/places/android-sdk/current-place),\nand [Place Details (New)](/maps/documentation/places/android-sdk/details-place)\nrequests.\n\nTo request an icon image and background color for a place, include the\nfollowing fields in your request:\n\n- `Place.Field.ICON_MASK_URL`\n- `Place.Field.ICON_BACKGROUND_COLOR`\n\nThe following examples demonstrate using the icon image and background color\nfrom a Current Place or Place Details request: \n\n### Kotlin\n\n```kotlin\n // Set the image view's background color to match the place's icon background color\n imageView.setBackgroundColor(place.iconBackgroundColor)\n\n // Fetch the icon using Glide and set the result in the image view\n Glide.with(this)\n .load(place.iconUrl)\n .into(imageView)\n\n \n```\n\n### Java\n\n```java\n // Set the image view's background color to match the place's icon background color\n imageView.setBackgroundColor(place.getIconBackgroundColor());\n\n // Fetch the icon using Glide and set the result in the image view\n Glide.with(this)\n .load(place.getIconUrl())\n .into(imageView);\n\n \n```\nThis example uses the [Glide](https://github.com/bumptech/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.\n\nFields\n------\n\nEach Place icon contains these fields:\n\n- `ICON_MASK_URL` returns the base URL for a non-colored PNG icon.\n- `ICON_BACKGROUND_COLOR` returns the default color code for the place's category.\n\nPlace icon and background color requests\n----------------------------------------\n\nThe following tables show all of the available place icons by category. By\ndefault these display with a black glyph. The icon background color\nis dictated by the place's category.\n\n| **Place category: Food and drink** (icon background color #FF9E67) ||||\n|--------------------------------------------------------------------|-----------------------------------------|----------------------|------------------|\n| Bar, Night club | Cafe | Restaurant, Bakery |\n| Books, Clothing, Electronics, Jewelry, Shoes, Shopping center/Mall | Convenience store | Grocery, Supermarket | Pharmacy |\n| ATM | Bank | Gas | Lodging |\n| Post office |\n| Aquarium, Tourist | Golf | Historic | Movie |\n| Museum | Theater |\n| Airport | Bus, rideshare, taxi | Train/Rail |\n| Cemetery | Civic building | Library | Monument |\n| Parking | School (primary, secondary, university) | Worship (Christian) |\n| Worship (Hindu) | Worship (Islam) | Worship (Jain) | Worship (Jewish) |\n| Worship (Sikh) | Generic business |\n| Boating | Camping | Park | Stadium |\n| Zoo |\n| Hospital | Police |"]]
