Ícones de lugares

Selecione a plataforma: Android iOS JavaScript Web Service

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
Bar,
Clube noturno
Café
Café
Restaurante
Restaurante, padaria
Categoria do lugar: varejo
(cor #4B96F3 do plano de fundo do ícone)
Livraria
Livros, roupas, eletrônicos, joias, sapatos,
Shopping Center
Loja de conveniência
Loja de conveniência
Mercearia
Mercearia, supermercado
Farmácia
Farmácia
Categoria do lugar: serviços
(cor #909CE1 do plano de fundo do ícone)
Caixa eletrônico
Caixa eletrônico
Banco
Banco
Postos de gasolina
Postos de gasolina
Hospedagem
Hospedagem
Correio
Correio
Categoria do lugar: entretenimento
(cor #13B5C7 do plano de fundo do ícone)
Aquário, turista
Aquário, turista
Golfe
Golfe
Histórico
Histórico
Filme
Filme
Museu
Museu
Teatro
Teatro
Categoria do lugar: transporte
(cor #10BDFF do plano de fundo do ícone)
Aeroporto
Aeroporto
Ônibus
Ônibus, serviço de transporte por aplicativo, táxi
Trem/Via férrea
Trem/Via férrea
Categoria do lugar: municipal/genérico/religioso
(cor #7B9EB0 do plano de fundo do ícone)
Cemitério
Cemitério
Construção civil
Construção civil
Biblioteca
Biblioteca
Monumento
Monumento
Estacionamento
Estacionamento
Escola (primária, secundária, universidade)
Escola (primária, secundária, universidade)
Igreja (cristã)
Igreja (cristã)
Templo (hindu)
Templo (hindu)
Mesquita (islâmica)
Mesquita (islâmica)
Templo (jainista)
Templo (jainista)
Templo (judeu)
Templo (judeu)
Templo (siquista)
Templo (siquista)
Empresa genérica
Empresa genérica
Categoria do lugar: ao ar livre
(cor #4DB546 do plano de fundo do ícone)
Barco
Barco
Acampamento
Acampamento
Parque
Parque
Estádio
Estádio
Zoológico
Zoológico
Categoria do lugar: emergência
(cor #F88181 do plano de fundo do ícone)
Hospital
Hospital
Polícia
Polícia