Les icônes de lieu indiquent les différents types d'adresses (cafés, bibliothèques et musées, par exemple). Vous pouvez demander des URL d'icônes au format PNG ou SVG, ainsi que la couleur d'arrière-plan correspondante pour 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, 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 HEX 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 les API Places (Nouveau) et 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 (New) (Recherche de texte (New)) pour renvoyer le nom à afficher d'un lieu, ainsi que les champs de réponse iconMaskBaseUri
et 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 une requête Find Place qui inclut les champs 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'URI de l'icône renvoyée, puis combinez-la 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 |
Carburant |
Hébergement |
Bureau de poste |
|||
Catégorie de lieu : divertissement (couleur d'arrière-plan de l'icône #13B5C7) |
|||
Aquarium, tourisme |
Golf |
Historique |
Film |
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 |