Ortssymbole

Plattform auswählen: Android iOS JavaScript Webdienst

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
Bar,
Nachtclub
Café
Café
Restaurant
Restaurant, Bäckerei
Ortskategorie: Einzelhandel
(Symbolhintergrundfarbe #4B96F3)
Buchhandlung
Bücher, Kleidung, Elektronik, Schmuck, Schuhe,
Einkaufszentrum
Minimarkt
Minimarkt
Lebensmittelgeschäft
Lebensmittelgeschäft, Supermarkt
Apotheke
Apotheke
Ortskategorie: Dienstleistungen
(Symbolhintergrundfarbe #909CE1)
Geldautomat
Geldautomat
Bank
Bank
Tankstelle
Benzin
Unterkunft
Unterkunft
Postfiliale
Postfiliale
Ortskategorie: Unterhaltung
(Symbolhintergrundfarbe #13B5C7)
Aquarium, touristisch
Aquarium, touristisch
Golf
Golf
Historisch
Historisch
Film
Film
Museum
Museum
Theater
Kino
Ortskategorie: Transport
(Symbolhintergrundfarbe #10BDFF)
Flughafen
Flughafen
Bus
Bus, Mitfahrdienst, Taxi
Züge/Bahnen
Züge/Bahnen
Ortskategorie: Gemeinde/allgemein/religiös
(Symbolhintergrundfarbe #7B9EB0)
Friedhof
Friedhof
Öffentliches Gebäude
Öffentliches Gebäude
Bibliothek
Mediathek
Denkmal
Denkmal
Parkplatzsituation
Parkplatz
Schule (Grundschule, Sekundarstufe, Universität)
Schule (Grundschule, Sekundarstufe, Universität)
Andachtsstätte (christlich)
Andachtsstätte (christlich)
Andachtsstätte (Hindu)
Andachtsstätte (Hindu)
Andachtsstätte (Islam)
Andachtsstätte (Islam)
Andachtsstätte (Jainismus)
Andachtsstätte (Jainismus)
Andachtsstätte (jüdisch)
Andachtsstätte (jüdisch)
Andachtsstätte (Sikh)
Andachtsstätte (Sikh)
Allgemeines Unternehmen
Allgemeines Unternehmen
Ortskategorie: Outdoor
(Symbolhintergrundfarbe #4DB546)
Bootsfahrten
Bootsfahrten
Camping
Camping
Park
Park
Stadion
Stadion
Zoo
Zoo
Ortskategorie: Notfall
(Symbolhintergrundfarbe #F88181)
Krankenhaus
Krankenhaus
Polizei
Polizei