Se usó la API de Cloud Translation para traducir esta página.

Í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.

Las URLs de los íconos pueden cambiar, así que asegúrate de usar siempre URI base de ícono para buscar la URL de un ícono. El plan de La API de Places admite el campo de respuesta icon. No utilizar icon, pero, en su lugar, usa icon_background_color y icon_mask_base_uri por la API de Places existente.

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