Os ícones de lugares indicam os vários tipos de lugar (por exemplo, cafés, bibliotecas e museus). Você pode solicitar URLs para ícones nos formatos PNG ou SVG, bem como a cor de fundo do ícone correspondente, com as solicitações Find Place, Place Details, Nearby Search e Text Search. É possível usar ícones inline.
O exemplo a seguir mostra uma solicitação do Find Place que inclui os campos icon_mask_base_uri
e icon_background_color
:
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
Exemplo de resposta
O exemplo a seguir mostra como os campos icon_mask_base_uri
e icon_background_color
aparecem em uma resposta de uma solicitação do Find Place. Para usar o URL, anexe a extensão de tipo de arquivo (.png ou .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>
Campos
Cada ícone de lugar contém estes campos:
icon
retorna o URL de um ícone PNG colorido de 71 x 71 pixels.icon_mask_base_uri
retorna o URL base de um ícone não colorido, menos a extensão do tipo de arquivo (anexar.svg
ou.png
).icon_background_color
retorna o código de cor hexadecimal padrão para a categoria do local.
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. O icon_background_color
é determinado 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 |
Gás |
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/vail |
|
Categoria do lugar: municipal/genérico/religioso (cor #7B9EB0 do plano de fundo do ícone) |
|||
Cemitério |
Construção cívica |
Biblioteca |
Monumento |
Estacionamento |
Escola (primária, secundária, universidade) |
Templo (budista) |
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) |
|||
Hospital |
Polícia |