Ortssymbole kennzeichnen die verschiedenen Arten von Orten (z. B. Cafés, Bibliotheken und Museen). Bei „Find Place“-, „Place Details“-, „Nearby Search“- und „Text Search“-Anfragen können Sie URLs für Symbole im PNG- oder SVG-Format sowie die entsprechende Symbolhintergrundfarbe anfordern. Symbole können inline verwendet werden.
Jedes Symbol wird durch zwei Antwortfelder definiert:
- Der Basis-URI des Symbols enthält die Basis-URL für ein nicht farbiges Symbol ohne die Dateityperweiterung. Sie müssen
.svg
oder.png
an den URI anhängen, um das Symbol anzufordern. - Die Symbolhintergrundfarbe enthält den standardmäßigen Hex-Farbcode für die Kategorie des Ortes.
Beispiel
In den folgenden Beispielen wird gezeigt, wie Sie einen Symbol-URI und eine Hintergrundfarbe für die Places API (New) und die Places API anfordern. Die Anfrage und die Antworten sind für die beiden Versionen der API unterschiedlich.
Places API (New)
Im folgenden Beispiel wird mit Text Search (New) der Anzeigename eines Ortes sowie die Antwortfelder iconMaskBaseUri
und iconBackgroundColor
zurückgegeben:
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'
Die Antwort hat das folgende Format:
{ "places": [ { "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "iconBackgroundColor": "#FF9E67", "displayName": { "text": "SKÖG Haus Coffee & Tea", "languageCode": "en" } } ] }
Places API
Das folgende Beispiel zeigt eine Find Place-Anfrage, die die Felder icon_mask_base_uri
und icon_background_color
enthält:
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
Das folgende Beispiel zeigt, wie die Felder icon_mask_base_uri
und icon_background_color
in der Antwort auf eine „Find Place“-Anfrage zurückgegeben werden.
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>
Um ein Symbol anzuzeigen, hängen Sie die gewünschte Dateityperweiterung („.svg“ oder „.png“) an den zurückgegebenen Symbol-URI an und kombinieren das Symbol mit der zurückgegebenen Hintergrundfarbe. So zeigen Sie beispielsweise das SVG-Symbol auf einer Webseite an:
<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"/>
Anfragen für Ortssymbole und Hintergrundfarben
In den folgenden Tabellen finden Sie alle verfügbaren Ortssymbole nach Kategorie. Standardmäßig werden sie mit einer schwarzen Glyphe angezeigt. Die Hintergrundfarbe des Symbols richtet sich nach der Kategorie des Orts.
Ortskategorie: Essen und Trinken (Symbolhintergrundfarbe #FF9E67) |
|||
---|---|---|---|
Bar, Nachtclub |
Café |
Restaurant, Bäckerei |
|
Ortskategorie: Einzelhandel (Symbolhintergrundfarbe #4B96F3) |
|||
Bücher, Kleidung, Elektronik, Schmuck, Schuhe, Einkaufszentrum |
Minimarkt |
Lebensmittelgeschäft, Supermarkt |
Apotheke |
Ortskategorie: Dienstleistungen (Symbolhintergrundfarbe #909CE1) |
|||
Geldautomat |
Bank |
Benzin |
Unterkunft |
Postfiliale |
|||
Ortskategorie: Unterhaltung (Symbolhintergrundfarbe #13B5C7) |
|||
Aquarium, touristisch |
Golf |
Historisch |
Film |
Museum |
Kino |
||
Ortskategorie: Transport (Symbolhintergrundfarbe #10BDFF) |
|||
Flughafen |
Bus, Mitfahrdienst, Taxi |
Züge/Bahnen |
|
Ortskategorie: Gemeinde/allgemein/religiös (Symbolhintergrundfarbe #7B9EB0) |
|||
Friedhof |
Öffentliches Gebäude |
Mediathek |
Denkmal |
Parkplatz |
Schule (Grundschule, Sekundarstufe, Universität) |
Andachtsstätte (christlich) |
|
Andachtsstätte (Hindu) |
Andachtsstätte (Islam) |
Andachtsstätte (Jainismus) |
Andachtsstätte (jüdisch) |
Andachtsstätte (Sikh) |
Allgemeines Unternehmen |
||
Ortskategorie: Outdoor (Symbolhintergrundfarbe #4DB546) |
|||
Bootsfahrten |
Camping |
Park |
Stadion |
Zoo |
|||
Ortskategorie: Notfall (Symbolhintergrundfarbe #F88181) |
|||
Krankenhaus |
Polizei |