Le icone dei luoghi indicano i vari tipi di luoghi (ad esempio caffetterie, biblioteche e musei). Puoi richiedere gli URL per le icone in formato PNG o SVG e per il colore di sfondo dell'icona corrispondente con le richieste Trova luogo, Dettagli luogo, Ricerca nelle vicinanze e Ricerca testuale. 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. Devi aggiungere
.svg
o.png
all'URI per richiedere l'icona. - 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 dell'icona e il colore di sfondo per l'API Places (nuova) e l'API Places. Nota che la richiesta e le risposte sono diverse per le due versioni dell'API.
API Places (Novità)
L'esempio seguente utilizza
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 Find Place, 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 vengono visualizzati i campi icon_mask_base_uri
e icon_background_color
in una risposta di una richiesta 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>
Per visualizzare un'icona, aggiungi l'estensione del tipo di file desiderata (.png o .svg) all'URI dell'icona restituita e combina l'icona con il colore di sfondo restituito. Ad esempio, per visualizzare l'icona .svg in 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"/>
Richieste di colore sfondo e icona del luogo
Le seguenti tabelle mostrano tutte le icone dei luoghi disponibili per categoria. Per impostazione predefinita, vengono visualizzate con un glifo nero. Il colore di sfondo dell'icona è determinato dalla categoria del luogo.
Categoria del luogo: Cibi e bevande (colore sfondo icona #FF9E67) |
|||
---|---|---|---|
Bar, Discoteca |
Bar |
Ristorante, panetteria |
|
Categoria luogo: Vendita al dettaglio (colore sfondo icona #4B96F3) |
|||
Libri, abbigliamento, elettronica, gioielli, scarpe, centro commerciale/centro commerciale |
Minimarket |
Alimentari, supermercato |
Farmacia |
Categoria luogo: Servizi (colore sfondo icona #909CE1) |
|||
bancomat |
Banca |
Benzina |
Alloggio |
Ufficio postale |
|||
Categoria luogo: Intrattenimento (colore sfondo icona #13B5C7) |
|||
Acquario, turistico |
Golf |
Storico |
Film |
Museo |
Cinema |
||
Categoria luogo: Trasporti (colore sfondo icona #10BDFF) |
|||
Aeroporto |
Autobus, ridesharing, taxi |
Treno/ferrovia |
|
Categoria luogo: municipale/generico/religioso (colore sfondo icona #7B9EB0) |
|||
Cimitero |
Edificio pubblico |
Raccolta |
Monumento |
Parcheggio |
Scuola (primaria, secondaria, università) |
Culto (cristiano) |
|
Adorazione (indù) |
Adorazione (islam) |
Adorazione (Giain) |
Adorazione (ebraica) |
Culto (sikh) |
Attività generica |
||
Categoria luogo: Esterno (colore sfondo icona #4DB546) |
|||
In barca |
Campeggio |
Parco |
Stadio |
Zoo |
|||
Categoria luogo: Emergenza (colore sfondo icona #F88181) |
|||
Ospedale |
Polizia |