Icônes de lieu

Introduction

Les icônes de lieu indiquent les différents types de lieux (cafés, bibliothèques et musées, par exemple). Vous pouvez demander des URL pour des icônes au format PNG ou SVG, ainsi que pour la couleur d'arrière-plan correspondante, avec les requêtes Find Place, Place Details, Nearby Search et Text Search. Les icônes peuvent être intégrées.

Chaque icône est définie par deux champs de réponse:

• L'URI de base de l'icône contient l'URL de base d'une icône non colorée, sans l'extension du type de fichier. Vous devez ajouter .svg ou .png à l'URI pour demander l'icône.
• La couleur d'arrière-plan de l'icône contient le code couleur hexadécimal par défaut pour la catégorie du lieu.

Exemple

Les exemples suivants montrent comment demander un URI d'icône et une couleur d'arrière-plan pour l'API Places (nouvelle) et l'API Places (ancienne). Notez que la requête et les réponses sont différentes pour les deux versions de l'API.

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'

{
  "places": [
    {
      "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
      "iconBackgroundColor": "#FF9E67",
      "displayName": {
        "text": "SKÖG Haus Coffee & Tea",
        "languageCode": "en"
      }
    }
  ]
}

    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

    {
      "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"
    }
          

    <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>
          

Pour afficher une icône, ajoutez l'extension de type de fichier (.png ou .svg) souhaitée à l'URI de l'icône renvoyée, puis combinez l'icône avec la couleur d'arrière-plan renvoyée. Par exemple, pour afficher l'icône .svg sur une page 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"/>

Requêtes d'icône de lieu et de couleur d'arrière-plan

Les tableaux suivants présentent toutes les icônes de lieu disponibles par catégorie. Par défaut, ces symboles s'affichent avec un glyphe noir. La couleur d'arrière-plan de l'icône est déterminée par la catégorie de lieu.

Catégorie de lieu : alimentation et boissons (couleur d'arrière-plan de l'icône #FF9E67)
Bar, boîte de nuit	Café	Restaurant, boulangerie
Catégorie de lieu : commerce de détail (couleur d'arrière-plan de l'icône #4B96F3)
Livres, vêtements, électronique, bijoux, chaussures, centre commercial	Supérette	Épicerie, supermarché	Pharmacie
Catégorie de lieu : services (couleur d'arrière-plan de l'icône #909CE1)
Distributeur de billets	Banque	Station-service	Hébergement
Bureau de poste
Catégorie de lieu : divertissement (couleur d'arrière-plan de l'icône #13B5C7)
Aquarium, tourisme	Golf	Historique	Films
Musée	Théâtre
Catégorie de lieu : transport (couleur d'arrière-plan de l'icône #10BDFF)
Aéroport	Bus, VTC, taxi	Train
Catégorie de lieu : municipal/générique/religieux (couleur d'arrière-plan de l'icône #7B9EB0)
Cimetière	Bâtiment municipal	Bibliothèque	Monument
Parking	École primaire, école secondaire, université	Lieu de culte (chrétien)
Lieu de culte (hindou)	Lieu de culte (islam)	Lieu de culte (jaïn)	Lieu de culte (juif)
Lieu de culte (sikh)	Entreprise générique
Catégorie de lieu : extérieur (couleur d'arrière-plan de l'icône #4DB546)
Nautisme	Camping	Parc	Stade
Zoo
Catégorie de lieu : service d'urgence (couleur d'arrière-plan de l'icône #F88181)
Hôpital	Police