Íconos de lugar

Selecciona la plataforma: Android iOS JavaScript Servicio web

Los iconos de lugar indican los diferentes tipos de lugares (por ejemplo, cafeterías, bibliotecas y museos). Puedes solicitar URLs para íconos en formato PNG o SVG. así como el color de fondo del ícono correspondiente, con Find Place, Solicitudes de Place Details, Nearby Search y Text Search Los íconos se pueden usar intercalados.

Cada ícono se define mediante dos campos de respuesta:

  • El URI base del ícono contiene la URL base de un elemento sin color menos la extensión del tipo de archivo. Debes agregar .svg o .png al URI para solicitar el ícono.
  • El color de fondo del ícono contiene el código de color hexadecimal predeterminado para la categoría del lugar.

Ejemplo

Los siguientes ejemplos muestran cómo solicitar un URI de ícono y un color de fondo para API de Places (nueva) y API de Places. Ten en cuenta que la solicitud y las respuestas son diferentes para las dos versiones de la API.

API de Places (nuevo)

En el siguiente ejemplo, se usan Text Search (nueva) para mostrar el nombre visible de un lugar, así como los valores de iconMaskBaseUri y Campos de respuesta 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'

La respuesta tiene el siguiente 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 de Places

En el siguiente ejemplo, se muestra un Solicitud de Find Place que incluye icon_mask_base_uri y icon_background_color campos:

    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

En el siguiente ejemplo, se muestra cómo aparecen los campos icon_mask_base_uri y icon_background_color en una respuesta a una solicitud de 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 mostrar un ícono, agrega la extensión del tipo de archivo que desees (.png o .svg) al ícono que se muestra URI y combina el ícono con el color de fondo que se muestra. Por ejemplo, para mostrar el ícono .svg en una página 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"/>

Solicitudes de íconos de lugar y colores de fondo

Las siguientes tablas muestran todos los íconos de lugar disponibles por categoría. De forma predeterminada, estos se muestran con un glifo negro. La categoría del lugar determina el color de fondo del ícono.

Categoría de lugar: Comidas y bebidas
(color de fondo del ícono #FF9E67)
Bar
Bar,
club nocturno
Cafetería
Cafetería
Restaurante
Restaurante, panadería
Categoría de lugar: Venta minorista
(color de fondo del ícono #4B96F3)
Librería
Libros, ropa, artículos electrónicos, artículos de joyería, calzado,
centro comercial
Minimercado
Minimercado
Tienda de alimentos
Tienda de alimentos, supermercado
Farmacia
Farmacia
Categoría de lugar: Servicios
(color de fondo del ícono #909CE1)
Cajero automático
Cajero automático
Banco
Banco
Gasolinera
Gasolinera
Alojamiento
Alojamiento
Oficina de correo
Oficina de correo
Categoría de lugar: Entretenimiento
(color de fondo del ícono #13B5C7)
Acuario, atracción turística
Acuario, atracción turística
Golf
Golf
Lugar histórico
Lugar histórico
Cine
Cine
Museo
Museo
Teatro
Teatro
Categoría de lugar: Transporte
(color de fondo del ícono #10BDFF)
Aeropuerto
Aeropuerto
Autobús
Autobús, transporte compartido, taxi
Tren o tren ligero
Tren o tren ligero
Categoría de lugar: Municipal/genérico/religioso
(color de fondo del ícono #7B9EB0)
Cementerio
Cementerio
Edificio municipal
Edificio municipal
Biblioteca
Biblioteca
Monumento
Monumento
Estacionamiento
Estacionamiento
Institución educativa (primaria, secundaria o universitaria)
Institución educativa (primaria, secundaria o universitaria)
Lugar de culto (cristiano)
Lugar de culto (cristiano)
Lugar de culto (hindú)
Lugar de culto (hindú)
Lugar de culto (islámico)
Lugar de culto (islámico)
Lugar de culto (jainista)
Lugar de culto (jainista)
Lugar de culto (judío)
Lugar de culto (judío)
Lugar de culto (sij)
Lugar de culto (sij)
Empresa genérica
Empresa genérica
Categoría de lugar: Actividades al aire libre
(color de fondo del ícono #4DB546)
Náutica
Náutica
Campamento
Campamento
Parque
Parque
Estadio
Estadio
Zoológico
Zoológico
Categoría de lugar: Emergencia
(color de fondo del ícono #F88181)
Hospital
Hospital
Policía
Policía