Icone di luoghi

Seleziona la piattaforma: Android iOS JavaScript Web Service

Le icone dei luoghi indicano i vari tipi di luoghi (ad esempio caffetterie, biblioteche e musei). Puoi richiedere gli URL delle icone in formato PNG o SVG, nonché il colore di sfondo corrispondente, con le richieste Trova luogo, Dettagli dei luoghi, Ricerca nelle vicinanze e Ricerca di testo. Le icone possono essere utilizzate in linea.

Ogni icona è definita da due campi di risposta:

  • L'URI di base dell'icona contiene l'URL di base di un'icona non colorata, meno l'estensione del tipo di file. Per richiedere l'icona, devi aggiungere .svg o .png all'URI.
  • Il colore di sfondo dell'icona contiene il codice colore esadecimale predefinito per la categoria del luogo.

Esempio

Gli esempi riportati di seguito mostrano come richiedere un URI icona e un colore di sfondo per l'API Places (nuova) e l'API Places. Tieni presente che la richiesta e le risposte sono diverse per le due versioni dell'API.

API Places (Novità)

L'esempio seguente utilizza la ricerca di testo (nuova) per restituire il nome visualizzato di un luogo, nonché i campi di risposta iconMaskBaseUri e 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 risposta è nel seguente 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

L'esempio seguente mostra una richiesta Trova luogo che include i campi 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

L'esempio seguente mostra come i campi icon_mask_base_uri e icon_background_color vengono visualizzati in una risposta a una richiesta di ricerca di un luogo.

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>
          

Per visualizzare un'icona, aggiungi l'estensione del tipo di file (.png o .svg) che preferisci all'URI icona restituito e combina l'icona con il colore di sfondo restituito. Ad esempio, per visualizzare l'icona .svg su una pagina 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"/>

Inviare richieste di icone e colori di sfondo

Le tabelle seguenti mostrano tutte le icone dei luoghi disponibili per categoria. Per impostazione predefinita, vengono visualizzati con un glifo nero. Il colore di sfondo dell'icona è determinato dalla categoria del luogo.

Categoria di luogo: Cibo e bevande
(colore dello sfondo dell'icona #FF9E67)
A barre
Bar,
Night club
Caffè
Bar
Ristorante
Ristorante, panificio
Categoria di luogo: vendita al dettaglio
(colore di sfondo dell'icona #4B96F3)
Libreria
Libri, abbigliamento, elettronica, gioielli, scarpe,
centro commerciale/galleria commerciale
Minimarket
Minimarket
Alimentari
Negozio di alimentari, supermercato
Farmacia
Farmacia
Categoria di luogo: Servizi
(colore sfondo icona #909CE1)
Bancomat
Bancomat
Banca
Banca
Gas
Gas
Alloggi
Alloggio
Ufficio postale
Ufficio postale
Categoria di luogo: Spettacoli
(colore di sfondo dell'icona #13B5C7)
Acquario, Turista
Acquario, Turistico
Golf
Golf
Storico
Storico
Film
Film
Museo
Museo
Teatro
Cinema
Categoria di luogo: Trasporti
(colore di sfondo dell'icona #10BDFF)
Aeroporto
Aeroporto
Bus
Autobus, ridesharing, taxi
Treno/ferrovia
Treno/mezzo su rotaie
Categoria di luogo: comunale/generico/religioso
(colore dello sfondo dell'icona #7B9EB0)
Cimitero
Cimitero
Edificio pubblico
Edificio pubblico
Raccolta
Raccolta
Monumento
Monumento
Parcheggio
Parcheggio
Scuola (elementare, secondaria, universitaria)
Scuola (elementare, media, universitaria)
Culto (cristiano)
Culto (cristiano)
Culto (indù)
Adorazione (indù)
Adorazione (Islam)
Culto (Islam)
Culto (giainista)
Culto (giainista)
Culto (ebraico)
Culto (ebraico)
Adorazione (sikh)
Culto (sikh)
Attività generica
Attività generica
Categoria di luogo: all'aperto
(colore sfondo icona #4DB546)
Nautica
Navigazione
Campeggio
Campeggio
Parco
Parcheggia
Stadio
Stadio
Zoo
Zoo
Categoria di luogo: Emergenza
(colore di sfondo dell'icona #F88181)
Ospedale
Ospedali
Polizia
Polizia