Ortssymbole

Plattform auswählen: Android iOS JavaScript Webdienst

Ortssymbole kennzeichnen die verschiedenen Arten von Orten, z. B. Cafés, Bibliotheken und Museen. Sie können URLs für Symbole im PNG- oder SVG-Format sowie die entsprechende Hintergrundfarbe des Symbols über „Ort finden“, „Place Details“, „Suchergebnisse in der Umgebung“ und „Text Search“-Anfragen anfordern. Symbole können inline verwendet werden.

Jedes Symbol wird durch zwei Antwortfelder definiert:

• Die Basis-URI des Symbols enthält die Basis-URL für ein nicht farbiges Symbol ohne die Dateityperweiterung. Sie müssen dem URI .svg oder .png anhängen, um das Symbol anzufordern.
• Die Hintergrundfarbe des Symbols enthält den standardmäßigen HEX-Farbcode für die Kategorie des Orts.

Symbol-URLs können sich ändern. Verwenden Sie daher immer die Basis-URI des Symbols, um die URL eines Symbols anzufordern. Die vorhandene Places API unterstützt das Antwortfeld icon. Verwenden Sie nicht das Feld icon, sondern icon_background_color und icon_mask_base_uri mit der vorhandenen Places API.

Beispiel

In den folgenden Beispielen wird gezeigt, wie Sie einen Symbol-URI und eine Hintergrundfarbe für die Places API (neu) und die Places API anfordern. Beachten Sie, dass sich die Anfrage und die Antworten für die beiden Versionen der API unterscheiden.

Places API (New)

Im folgenden Beispiel wird die Text Search (New) verwendet, um den Anzeigenamen eines Orts sowie die Antwortfelder iconMaskBaseUri und iconBackgroundColor zurückzugeben:

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 folgendes 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 mit den Feldern icon_mask_base_uri und 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

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>
          

Wenn Sie ein Symbol anzeigen möchten, hängen Sie die gewünschte Dateiendung („.png“ oder „.svg“) an den zurückgegebenen Symbol-URI an und kombinieren Sie das Symbol mit der zurückgegebenen Hintergrundfarbe. So fügen Sie beispielsweise das SVG-Symbol auf einer Webseite ein:

<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	Tankstelle	Unterkunft
Postfiliale
Ortskategorie: Unterhaltung (Symbolhintergrundfarbe #13B5C7)
Aquarium, touristisch	Golf	Historisch	Kino
Museum	Theater
Ortskategorie: Transport (Symbolhintergrundfarbe #10BDFF)
Flughafen	Bus, Mitfahrdienst, Taxi	Züge/Bahnen
Ortskategorie: Gemeinde/allgemein/religiös (Symbolhintergrundfarbe #7B9EB0)
Friedhof	Öffentliches Gebäude	Bibliothek	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