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 an, Place Details-, Nearby Search- und Text Search-Anfragen 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 einen nicht farbigen ohne die Dateityperweiterung. Sie müssen .svg oder .png an den URI, um das Symbol anzufordern.
• Die Hintergrundfarbe des Symbols enthält den standardmäßigen Hex-Farbcode für der Kategorie des Ortes zugeordnet.

Symbol-URLs können sich ändern. Verwenden Sie daher immer Basis-URI des Symbols, um die URL für ein Symbol zu suchen. Die vorhandene Die Places API unterstützt das Antwortfeld icon. Nicht verwenden icon-Feld, aber verwenden stattdessen icon_background_color und icon_mask_base_uri durch die vorhandene Places API.

Beispiel

Die folgenden Beispiele zeigen, wie ein Symbol-URI und eine Hintergrundfarbe für Places API (New) und Places API Die Anfrage und die Antworten unterscheiden sich. für die beiden API-Versionen.

Places API (New)

Im folgenden Beispiel werden Textsuche (neu) um den Anzeigenamen eines Ortes sowie die iconMaskBaseUri und iconBackgroundColor-Antwortfelder:

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 einschließlich icon_mask_base_uri und icon_background_color Felder:

    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 (.png oder .svg) an das zurückgegebene Symbol an URI und kombinieren Sie das Symbol mit der zurückgegebenen Hintergrundfarbe. Um beispielsweise das SVG-Symbol auf einer Webseite:

<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