Icônes de lieu

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Les icônes de lieu indiquent les différents types d'adresses (cafés, les bibliothèques et les musées). Vous pouvez demander des URL pour des icônes au format PNG ou SVG, ainsi que la couleur d'arrière-plan de l'icône correspondante, avec Find Place, Requêtes 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'un élément non coloré moins 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 API Places (nouvelle version) et API Places. Notez que la requête et les réponses sont différentes. pour les deux versions de l'API.

API Places (New)

L'exemple suivant utilise Text Search (nouvelle version) pour renvoyer le nom à afficher d'un lieu, ainsi que les éléments iconMaskBaseUri et Champs de réponse 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 réponse se présente sous la forme suivante:

{
  "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'exemple suivant montre Requête Find Place qui inclut les éléments icon_mask_base_uri et 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'exemple suivant montre comment les champs icon_mask_base_uri et icon_background_color apparaissent dans une réponse à une requête 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>
          

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