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.
di Gemini Advanced.

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)
A barre
Bar,
night club
Caffè
Bar
Ristorante
Ristorante, panetteria
Categoria del luogo: Vendita al dettaglio
(icon background color #4B96F3)
Libreria
Libri, abbigliamento, elettronica, gioielli, scarpe,
centro commerciale/centro commerciale
Minimarket
Minimarket
Alimentari
Alimentari, supermercato
Farmacia
Farmacia
Categoria del luogo: Servizi
(colore sfondo icona #909CE1)
Bancomat
Bancomat
Banca
Banca
Gas
Benzina
Alloggio
Alloggio
Ufficio postale
Ufficio postale
Categoria del luogo: Intrattenimento
(colore sfondo icona #13B5C7)
Acquario, Turista
Acquario, Turista
Golf
Golf
Storico
Storico
Film
Film
Museo
Museo
Teatro
Teatro
Categoria del luogo: Trasporti
(colore sfondo icona #10BDFF)
Aeroporto
Aeroporto
Bus
Autobus, ridesharing, taxi
Treno/treno
Treno/treno
Categoria del luogo: Municipale/generico/religioso
(colore sfondo icona #7B9EB0)
Cimitero
Cimitero
Edificio pubblico
Edificio pubblico
Raccolta
Biblioteca
Monumento
Monumento
Parcheggio
Parcheggio
Scuola (primaria, secondaria, università)
Scuola (primaria, secondaria, università)
Culto (cristiano)
Culto (cristiano)
Culto (indù)
Culto (indù)
Culto (Islam)
Culto (Islam)
Adorazione (Giaina)
Adorazione (Giaina)
Culto (ebraico)
Culto (ebraico)
Adorazione (sikh)
Adorazione (sikh)
Attività generica
Attività generica
Categoria del luogo: Esterni
(colore sfondo icona #4DB546)
Nautica
Nautica da diporto
Campeggio
Campeggio
Parco
Parco
Stadio
Stadio
Zoo
Zoo
Categoria del luogo: Emergenza
(colore sfondo icona #F88181)
Ospedale
Ospedale
Polizia
Polizia