Introduzione
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 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 .svgo.pngall'URI.
- Il colore di sfondo dell'icona contiene il codice colore esadecimale predefinito per la categoria del luogo.
Esempio
Gli esempi seguenti mostrano come richiedere un URI icona e un colore di sfondo per l'API Places (nuova) e l'API Places (legacy). 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 (legacy)
L'esempio seguente mostra una richiesta Trova luogo (legacy) 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 di una richiesta Trova un luogo (legacy).
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 visualizzato 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) | |||
|---|---|---|---|
| Bar, Night club | Bar | Ristorante, panificio | |
| Categoria di luogo: vendita al dettaglio (colore di sfondo dell'icona #4B96F3) | |||
| Libri, abbigliamento, elettronica, gioielli, scarpe, centro commerciale/galleria commerciale |  Minimarket | Negozio di alimentari, supermercato | Farmacia | 
| Categoria di luogo: Servizi (colore sfondo icona #909CE1) | |||
| Bancomat | Banca | Gas | Alloggio | 
| Ufficio postale | |||
| Categoria di luogo: Spettacoli (colore di sfondo dell'icona #13B5C7) | |||
| Acquario, Turistico | Golf | Storico | Film | 
| Museo | Cinema | ||
| Categoria di luogo: Trasporti (colore di sfondo dell'icona #10BDFF) | |||
| Aeroporto | Autobus, ridesharing, taxi | Treno/mezzo su rotaie | |
| Categoria di luogo: comunale/generico/religioso (colore dello sfondo dell'icona #7B9EB0) | |||
| Cimitero | Edificio pubblico | Raccolta | Monumento | 
| Parcheggio | Scuola (elementare, media, universitaria) | Culto (cristiano) | |
| Adorazione (indù) | Culto (Islam) | Culto (giainista) | Culto (ebraico) | 
| Culto (sikh) | Attività generica | ||
| Categoria di luogo: all'aperto (colore di sfondo dell'icona #4DB546) | |||
| Nautica | Campeggio | Parcheggia | Stadio | 
| Zoo | |||
| Categoria di luogo: Emergenza (colore di sfondo dell'icona #F88181) | |||
| Ospedali | Polizia | ||