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) |
|||
---|---|---|---|
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 sfondo icona #4DB546) |
|||
Navigazione |
Campeggio |
Parcheggia |
Stadio |
Zoo |
|||
Categoria di luogo: Emergenza (colore di sfondo dell'icona #F88181) |
|||
Ospedali |
Polizia |