Íconos de lugar

Selecciona la plataforma: Android iOS JavaScript Servicio web

Los íconos 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 las solicitudes Find Place, 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 ícono 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

En los siguientes ejemplos, se muestra cómo solicitar un URI de ícono y un color de fondo para la API de Places (nueva) y la 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 usa Text Search (New) para mostrar el nombre visible de un lugar y los campos de respuesta iconMaskBaseUri y 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 una solicitud de Find Place que incluye los campos icon_mask_base_uri y 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

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 de tipo de archivo deseada (.png o .svg) al URI del ícono que se muestra y combina el ícono con el color de fondo que se muestra. Por ejemplo, para mostrar el ícono .svg en una página web, haz lo siguiente:

<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
Película
Película
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 cívico
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