Ortstypen sind Kategorien, die die Merkmale eines Orts beschreiben. Einem Ort können einer oder mehrere Ortstypen zugewiesen werden.
Die Typen eines Orts sind in der Antwort einer „Place Details (New)“, „Nearby Search (New)“, „Text Search (New)“ und „Autocomplete (New)“-Anfrage enthalten:
- Ein Ort kann einen einzelnen primären Typ vom Typ Tabelle A oder vom Typ Tabelle B haben.
Der primäre Typ kann beispielsweise
mexican_restaurant
odersteak_house
sein. - Ein Ort kann mehrere Typwerte aus dem Typ Tabelle A oder dem Typ Tabelle B haben.
Ein Restaurant kann beispielsweise die folgenden Typen haben:
seafood_restaurant
,restaurant
,food
,point_of_interest
,establishment
. - Die Adresse und die Adresskomponenten eines Orts können mit bestimmten Typen aus der Tabelle Typen von Adressen und Adresskomponenten getaggt werden. So kann beispielsweise eine Adresse als
street_address
und eine Komponente der Adresse alsstreet_number
getaggt werden.
Sie können auch Ortstypen als Teil einer Anfrage angeben. Wenn der Typ in der Anfrage angegeben ist, dient er als Filter, um die Antwort auf Orte zu beschränken, die den angegebenen Typen entsprechen.
Tabellen mit Typen
In Tabelle A sind die Typen aufgeführt, die folgendermaßen verwendet werden:
- Im Rahmen einer Antwort von „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“. In der Anfrage muss mindestens eines der folgenden Felder in der Feldmaske angegeben werden:
places.types
oderplaces.primaryType
. Die Werte in Tabelle A werden dann zum Ausfüllen dieser Felder verwendet. - Im Rahmen einer „Nearby Search (New)“-Anfrage als Wert der Parameter
includedTypes
,excludedTypes
,includedPrimaryTypes
undexcludedPrimaryTypes
. Die Werte in Tabelle B werden dann zum Ausfüllen dieser Felder verwendet. - Im Rahmen einer „Text Search (New)“-Anfrage als Wert des Parameters
includedType
. - Im Rahmen einer „Autocomplete (New)“-Anfrage als Werte des Parameters
includedPrimaryTypes
. - Im Rahmen einer Antwort vom Typ „Autocomplete (New)“.
In Tabelle B werden zusätzliche Werte für Ortstypen aufgelistet, die auch im Rahmen einer „Place Details (New)“-, „Nearby Search (New)“-, „Text Search (New)“- und „Autocomplete (New)“-Antwort zurückgegeben werden können. In der Anfrage muss mindestens eines der folgenden Felder in der Feldmaske angegeben werden: places.types
oder places.primaryType
. Werte aus Tabelle B dürfen NICHT als Teil einer Anfrage verwendet werden, außer als Werte für den Parameter includedPrimaryTypes
für eine „Autocomplete (New)“-Anfrage.
Adresstypen und Adresskomponententypen: Liste der Typen, die im Antworttext entweder im Array „Adresstyp“ oder im Array „Adresskomponententyp“ oder in beiden vorkommen können. Die Typen von Adresskomponenten können sich ändern.
Tabelle A
Automobil | ||
---|---|---|
car_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
Unternehmen | ||
corporate_office *farm ranch * |
||
Kultur | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Bildung | ||
library preschool primary_school
|
school secondary_school university
|
|
Unterhaltung und Freizeit | ||
adventure_sports_center *amphitheatre *amusement_center amusement_park aquarium banquet_hall barbecue_area *botanical_garden *bowling_alley casino childrens_camp *comedy_club *community_center concert_hall *convention_center cultural_center cycling_park *dance_hall *dog_park event_venue |
ferris_wheel *garden *hiking_area *historical_landmark internet_cafe *karaoke *marina movie_rental movie_theater national_park night_club observation_deck *off_roading_area *opera_house *park philharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attraction video_arcade *visitor_center water_park *wedding_venue wildlife_park *wildlife_refuge *zoo
|
Räumlichkeiten | ||
public_bath *public_bathroom *stable *
|
||
Finanzen | ||
accounting atm bank
|
||
Essen und Trinken | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurant asian_restaurant *bagel_shop *bakery bar bar_and_grill *barbecue_restaurant brazilian_restaurant breakfast_restaurant brunch_restaurant buffet_restaurant *cafe cafeteria *candy_store *cat_cafe *chinese_restaurant chocolate_factory *chocolate_shop *coffee_shop confectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurant fine_dining_restaurant *food_court *french_restaurant greek_restaurant hamburger_restaurant ice_cream_shop indian_restaurant indonesian_restaurant italian_restaurant japanese_restaurant juice_shop *korean_restaurant *lebanese_restaurant meal_delivery meal_takeaway mediterranean_restaurant |
mexican_restaurant middle_eastern_restaurant pizza_restaurant pub *ramen_restaurant restaurant sandwich_shop seafood_restaurant spanish_restaurant steak_house sushi_restaurant tea_house *thai_restaurant turkish_restaurant vegan_restaurant vegetarian_restaurant vietnamese_restaurant wine_bar *
|
Regionen | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Behörden | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (nur Japan)police post_office
|
|
Gesundheit und Wohlbefinden | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Wohnen | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Unterkunft | ||
bed_and_breakfast budget_japanese_inn *campground camping_cabin cottage extended_stay_hotel farmstay guest_house
hostel *hotel * |
inn *japanese_inn *lodging mobile_home_park *motel private_guest_room resort_hotel rv_park
|
|
Geografische Elemente | ||
beach *
|
||
Religiöse Orte | ||
church hindu_temple mosque synagogue
|
||
Dienste | ||
astrologer *barber_shop beautician *beauty_salon body_art_service *catering_service *cemetery child_care_agency consultant courier_service electrician florist food_delivery *foot_care *funeral_home hair_care hair_salon insurance_agency laundry * |
lawyer locksmith makeup_artist *moving_company nail_salon *painter plumber psychic *real_estate_agency roofing_contractor storage summer_camp_organizer *tailor telecommunications_service_provider tour_agency *tourist_information_center *travel_agency veterinary_care
|
|
Shopping | ||
asian_grocery_store *auto_parts_store bicycle_store book_store butcher_shop *cell_phone_store clothing_store convenience_store department_store discount_store electronics_store food_store *furniture_store gift_shop grocery_store hardware_store home_goods_store
|
home_improvement_store jewelry_store liquor_store market pet_store shoe_store shopping_mall sporting_goods_store store supermarket warehouse_store *wholesaler
|
|
Sport | ||
arena *athletic_field fishing_charter *fishing_pond *fitness_center golf_course gym ice_skating_rink * |
playground *ski_resort sports_activity_location *sports_club sports_coaching *sports_complex stadium swimming_pool
|
|
Transport | ||
airport airstrip *bus_station bus_stop ferry_terminal heliport international_airport *light_rail_station |
park_and_ride *subway_station taxi_stand train_station transit_depot transit_station truck_stop
|
Tabelle B
Die Werte für den Ortstyp in Tabelle B können im Rahmen einer Antwort von „Place Details (New)“, „Nearby Search (New)“, „Text Search (New)“ oder „Autocomplete (New)“ zurückgegeben werden. Diese Typen werden auch von includedPrimaryTypes
für Anfragen vom Typ „Autocomplete (New)“ unterstützt.
Zusätzliche Werte für Ortstypen | ||
---|---|---|
administrative_area_level_3 administrative_area_level_4 administrative_area_level_5 administrative_area_level_6 administrative_area_level_7 archipelago colloquial_area continent establishment finance food general_contractor geocode health intersection landmark natural_feature neighborhood place_of_worship plus_code
|
point_of_interest political postal_code_prefix postal_code_suffix postal_town premise route street_address sublocality sublocality_level_1 sublocality_level_2 sublocality_level_3 sublocality_level_4 sublocality_level_5 subpremise town_square
|
Typen von Adressen und Adresskomponenten
Das types
-Array in der Antwort gibt den Adresstyp an. Beispiele für Adresstypen sind eine Privatadresse, ein Land oder eine politische Einheit. Das types
-Array im Feld AddressComponent
gibt den Typ der einzelnen Teile der Adresse an. Dazu gehören bspw. Hausnummer oder Land.
Adressen können mehrere Typen aufweisen. Die Typen können als „Tags“ betrachtet werden.
Viele Städte haben z. B. Tags vom Typ political
und locality
.
Die folgenden Typen werden sowohl in den Arrays für Adresstypen als auch in den Arrays für Adresskomponenten unterstützt und zurückgegeben:
Adresstyp | Beschreibung |
---|---|
street_address |
Eine genaue Adresse. |
route |
Eine Straße mit einer Bezeichnung, z. B. „B1“. |
intersection |
Eine größere Kreuzung, üblicherweise von zwei Hauptstraßen. |
political |
Eine politische Einheit. Normalerweise zeigt dieser Typ ein Polygon an, das einer öffentlichen Verwaltungseinheit entspricht. |
country |
Die nationale Verwaltungseinheit, in der Regel die der höchsten Ebene. |
administrative_area_level_1 |
Eine öffentliche Verwaltungseinheit eine Stufe unterhalb der Landesebene. In den USA sind diese Verwaltungsebenen die Bundesstaaten. Diese Verwaltungsebenen gibt es nicht in allen Ländern. In den meisten Fällen sind Kurzbezeichnungen dieses Typs eng an die Untereinheiten des Standards ISO 3166-2 und andere gängige Definitionen angelehnt. Eine Garantie hierfür können wir jedoch nicht geben, da unsere Geocoding-Ergebnisse auf verschiedenen Signalen und Standortdaten basieren.administrative_area_level_1 |
administrative_area_level_2 |
Eine öffentliche Verwaltungseinheit zwei Stufen unterhalb der Landesebene. In den USA sind diese Verwaltungsebenen die Countys. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
administrative_area_level_3 |
Eine öffentliche Verwaltungseinheit drei Stufen unterhalb der Landesebene. Dieser Typ steht für eine kleine Verwaltungseinheit von geringerer Bedeutung. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
administrative_area_level_4 |
Eine öffentliche Verwaltungseinheit vier Stufen unterhalb der Landesebene. Dieser Typ steht für eine kleine Verwaltungseinheit von geringerer Bedeutung. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
administrative_area_level_5 |
Eine öffentliche Verwaltungseinheit fünf Stufen unterhalb der Landesebene. Dieser Typ steht für eine kleine Verwaltungseinheit von geringerer Bedeutung. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
administrative_area_level_6 |
Eine öffentliche Verwaltungseinheit sechs Stufen unterhalb der Landesebene. Dieser Typ steht für eine kleine Verwaltungseinheit von geringerer Bedeutung. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
administrative_area_level_7 |
Eine öffentliche Verwaltungseinheit sieben Stufen unterhalb der Landesebene. Dieser Typ steht für eine kleine Verwaltungseinheit von geringerer Bedeutung. Diese Verwaltungsebenen gibt es nicht in allen Ländern. |
colloquial_area |
Ein gängiger alternativer Name für die Entität. |
locality |
Eine politische Einheit in Form einer Stadt oder Gemeinde. |
sublocality |
Eine öffentliche Verwaltungseinheit eine Stufe unterhalb des Ortes. Für einige Standorte wird möglicherweise einer der folgenden zusätzlichen Typen ausgegeben: sublocality_level_1 bis sublocality_level_5 . Jede dieser Ebenen entspricht einer Verwaltungseinheit. Je höher die Zahl, desto kleiner das geografische Gebiet. |
neighborhood |
Ein benanntes Viertel. |
premise |
Ein benannter Ort, in der Regel ein Gebäude oder ein Komplex von Gebäuden mit einem gemeinsamen Namen. |
subpremise |
Eine adressierbare Entität unterhalb der Standortebene, z. B. eine Wohnung oder ein Appartement. |
plus_code |
Ein codierter Verweis auf den Standort, der sich aus Breiten- und Längengrad ableiten lässt. Plus Codes können als Ersatz für Adressen verwendet werden, wenn keine Adressen vorhanden sind, z. B. wenn Gebäude keine Hausnummern oder Straßen keine Namen haben. Weitere Informationen finden Sie unter https://plus.codes. |
postal_code |
Eine Postleitzahl, wie sie zum Adressieren von Postsendungen innerhalb des Landes verwendet wird. |
natural_feature |
Ein markantes Landschaftsmerkmal. |
airport |
Ein Flughafen. |
park |
Ein benannter Park. |
point_of_interest |
Ein benannter POI. In der Regel sind diese POIs bekannte lokale Objekte, die sich keiner anderen Kategorie zuordnen lassen, z. B. das Brandenburger Tor oder der Eiffelturm. |
Eine leere Typenliste bedeutet, dass für eine bestimmte Adresskomponente keine Typen vorhanden sind, wie z. B. ein Lieu-dit in Frankreich.
Zusätzlich können die Adresskomponenten die unten aufgeführten Typen enthalten.
Adresskomponententyp | Beschreibung |
---|---|
floor |
Das Stockwerk einer Gebäudeadresse. |
establishment |
In der Regel ein Ort, der noch nicht kategorisiert wurde. |
landmark |
Ein Ort in der Nähe, der als Referenz zur Orientierung dient. |
point_of_interest |
Ein benannter POI. |
parking |
Ein Parkplatz oder ein Parkhaus. |
post_box |
Einen bestimmten Briefkasten. |
postal_town |
Eine Gruppe geografischer Gebiete wie locality und sublocality , die in einigen Ländern als Postanschriften verwendet werden. |
room |
Der Raum einer Gebäudeadresse. |
street_number |
Die genaue Hausnummer. |
bus_station , train_station und transit_station |
Der Standort einer Bushaltestelle, einer Bahnhaltestelle oder einer Haltestelle des öffentlichen Nahverkehrs. |