Ícones de lugares

Introdução

Os ícones de lugar indicam os vários tipos de local (por exemplo, cafés, bibliotecas e museus). Você pode solicitar URLs para ícones nos formatos PNG ou SVG, bem como a cor de plano de fundo do ícone correspondente, com solicitações do Find Place, Place Details, Nearby Search e Text Search. É possível usar ícones inline.

Cada ícone é definido por dois campos de resposta:

• O URI de base do ícone contém o URL de base de um ícone sem cor, menos a extensão do tipo de arquivo. É necessário anexar .svg ou .png ao URI para solicitar o ícone.
• A cor 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 a API Places (nova) e a API Places (legada). Observe que a solicitação e as respostas são diferentes para as duas versões da API.

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'

{
  "places": [
    {
      "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
      "iconBackgroundColor": "#FF9E67",
      "displayName": {
        "text": "SKÖG Haus Coffee & Tea",
        "languageCode": "en"
      }
    }
  ]
}

    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

    {
      "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"
    }
          

    <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 mostrar um ícone, anexe a extensão de tipo de arquivo (.png ou .svg) que você quer ao URI do ícone retornado e combine o ícone com a cor de plano de fundo retornada. Por exemplo, para mostrar 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