Os ícones de lugar indicam os vários tipos de lugar (por exemplo, cafés, bibliotecas e museus). É possível solicitar URLs para ícones nos formatos PNG ou SVG, e a cor de fundo do ícone correspondente, com o recurso Find Place, Solicitações de Place Details, Nearby Search e Text Search. É possível usar ícones inline.
Cada ícone é definido por dois campos de resposta:
- O URI de base de ícone contém o URL de base para um objeto
menos a extensão do tipo de arquivo. É preciso anexar
.svg
ou.png
ao URI para solicitar o ícone. - A cor de plano de fundo do ícone contém o código de cor hexadecimal padrão para a categoria do lugar.
Exemplo
Os exemplos a seguir mostram como solicitar um URI de ícone e uma cor de plano de fundo para API Places (nova) e API Places. A solicitação e as respostas são diferentes para as duas versões da API.
API Places (nova)
O exemplo a seguir usa
Text Search (novo)
para retornar o nome de exibição de um local, bem como os iconMaskBaseUri
e
Campos de resposta iconBackgroundColor
:
curl -X POST -d '{ "textQuery" : "skog haus", "maxResultCount" : 1 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \ 'https://places.googleapis.com/v1/places:searchText'
A resposta está no formato:
{ "places": [ { "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "iconBackgroundColor": "#FF9E67", "displayName": { "text": "SKÖG Haus Coffee & Tea", "languageCode": "en" } } ] }
API Places
O exemplo a seguir mostra
solicitação Find Place
que inclui 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=API_KEY
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.
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>
Para exibir um ícone, anexe a extensão de tipo de arquivo desejada (.png ou .svg) ao ícone retornado. URI e combinar o ícone com a cor de fundo retornada. Por exemplo, para exibir o ícone .svg em uma página da Web:
<style> .icons-food-drink { background-color: #FF9E67; width: 88px; height: 88px; padding: 5px; } </style> <img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>
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) |
|||
Hospital |
Polícia |