Icone dei luoghi

Seleziona la piattaforma: Android iOS JavaScript Servizio web

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.

Gli URL delle icone possono cambiare, quindi assicurati di usare sempre URI di base dell'icona per cercare un'icona nell'URL. L'attuale L'API Places supporta il campo di risposta icon. Non utilizzare icon ma usa icon_background_color e icon_mask_base_uri con l'API Places esistente.

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