Le icone dei luoghi indicano i vari tipi di luoghi (ad esempio bar, biblioteche e musei). Puoi richiedere gli URL delle icone in formato PNG o SVG, e il colore di sfondo dell'icona corrispondente, con Trova luogo, Richieste Place Details, Nearby Search e Text Search. 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 per un URL non colorato
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 predefinito esadecimale per la categoria del luogo.
Esempio
I seguenti esempi mostrano come richiedere un URI dell'icona e un colore di sfondo per API Places (nuova) e 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 testuale (novità)
per restituire il nome visualizzato di un luogo, nonché iconMaskBaseUri
e
iconBackgroundColor
campi di risposta:
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 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 un
Richiesta Trova luogo
che include icon_mask_base_uri
e icon_background_color
campi:
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 icon_mask_base_uri
e
I campi icon_background_color
vengono visualizzati in una risposta da Trova luogo
richiesta.
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'icona restituita. 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"/>
Richieste di icona luogo e colore di sfondo
Le seguenti tabelle mostrano tutte le icone dei luoghi disponibili per categoria. Di per impostazione predefinita vengono visualizzati con un glifo nero. Il colore di sfondo dell'icona è dettato dalla categoria del luogo.
Categoria del luogo: Cibo e bevande (colore sfondo icona #FF9E67) |
|||
---|---|---|---|
Bar, night club |
Bar |
Ristorante, panetteria |
|
Categoria del luogo: Vendita al dettaglio (icon background color #4B96F3) |
|||
Libri, abbigliamento, elettronica, gioielli, scarpe, centro commerciale/centro commerciale |
Minimarket |
Alimentari, supermercato |
Farmacia |
Categoria del luogo: Servizi (colore sfondo icona #909CE1) |
|||
Bancomat |
Banca |
Benzina |
Alloggio |
Ufficio postale |
|||
Categoria del luogo: Intrattenimento (colore sfondo icona #13B5C7) |
|||
Acquario, Turista |
Golf |
Storico |
Film |
Museo |
Teatro |
||
Categoria del luogo: Trasporti (colore sfondo icona #10BDFF) |
|||
Aeroporto |
Autobus, ridesharing, taxi |
Treno/treno |
|
Categoria del luogo: Municipale/generico/religioso (colore sfondo icona #7B9EB0) |
|||
Cimitero |
Edificio pubblico |
Biblioteca |
Monumento |
Parcheggio |
Scuola (primaria, secondaria, università) |
Culto (cristiano) |
|
Culto (indù) |
Culto (Islam) |
Adorazione (Giaina) |
Culto (ebraico) |
Adorazione (sikh) |
Attività generica |
||
Categoria del luogo: Esterni (colore sfondo icona #4DB546) |
|||
Nautica da diporto |
Campeggio |
Parco |
Stadio |
Zoo |
|||
Categoria del luogo: Emergenza (colore sfondo icona #F88181) |
|||
Ospedale |
Polizia |