Ortstypen sind Kategorien, die die Eigenschaften eines Orts angeben. Einem Ort können ein oder mehrere Ortstypen zugewiesen sein.
Die Typen eines Orts sind in der Antwort auf eine „Place Details (New)“-, „Nearby Search (New)“-, „Text Search (New)“- und „Autocomplete (New)“-Anfrage enthalten:
- Ein Ort kann einen einzelnen primären Typ aus Tabelle A oder Tabelle B haben.
Der primäre Typ kann beispielsweise
mexican_restaurantodersteak_housesein.Er fehlt möglicherweise, wenn der primäre Typ des Orts kein unterstützter Typ ist. Wenn ein primärer Typ vorhanden ist, ist er immer einer der Typen im Feldtypes. - Ein Ort kann mehrere Typwerte aus Tabelle A oder Tabelle B haben.
Ein Restaurant kann beispielsweise die folgenden Typen haben:
seafood_restaurant,restaurant,food,point_of_interest,establishment. - Die Adresse und Adresskomponenten eines Orts können mit bestimmten Typen aus der Tabelle Typen von Adressen und Adresskomponenten getaggt werden. Beispielsweise kann eine Adresse als
street_addressund eine Komponente der Adresse alsstreet_numbergekennzeichnet werden.
Sie können auch Ortstypen als Teil einer Anfrage angeben. Wenn der Typ in der Anfrage angegeben wird, dient er als Filter, um die Antwort auf Orte zu beschränken, die den angegebenen Typen entsprechen.
Typentabellen
In Tabelle A werden die unterstützten Werte für Ortstypen aufgelistet:
- Im Rahmen einer Antwort von „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“. 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,includedPrimaryTypesundexcludedPrimaryTypes. 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 „Place Autocomplete Widget (New)“-Anfrage als Werte des Parameters
includedPrimaryTypes. - Im Rahmen einer „Place Autocomplete Widget (New)“-Antwort.
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 „Place Autocomplete Widget (New)“-Antwort zurückgegeben werden können. In der Anfrage muss mindestens eines der Felder places.types oder places.primaryType in der Feldmaske angegeben werden.
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 „Place Autocomplete Widget (New)“-Anfrage.
Unter Typen von Adressen und Adresskomponenten finden Sie eine Liste der Typen, die im Antworttext in den Arrays für Adresstypen und/oder Adresskomponententypen enthalten sein können. Die Typen von Adresskomponenten können sich ändern.
Tabelle A
| Automobil | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| Unternehmen | ||
corporate_office *farmranch * |
||
| Kultur | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| Bildung | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| Unterhaltung und Freizeit | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue |
ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo
|
| Räumlichkeiten | ||
public_bath *public_bathroom *stable *
|
||
| Finanzen | ||
accountingatmbank
|
||
| Essen und Trinken | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant |
mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar *
|
| Regionen | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Behörden | ||
city_hallcourthouseembassyfire_stationgovernment_office *
|
local_government_officeneighborhood_police_station (nur Japan)policepost_office
|
|
| Gesundheit und Wohlbefinden | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| Wohnen | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| Unterkunft | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| Geografische Elemente | ||
beach *
|
||
| Religiöse Orte | ||
churchhindu_templemosquesynagogue
|
||
| Dienste | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * |
lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care
|
|
| Shopping | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store
|
home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler
|
|
| Sport | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * |
playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool
|
|
| Transport | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station |
park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_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 Autocomplete (New)-Anfragen unterstützt.
| Zusätzliche Werte für Ortstypen | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code
|
point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_square
|
|
Typen von Adressen und Adresskomponenten
Das types-Array in der Antwort gibt den Adresstyp an. Beispiele für Adresstypen sind eine Straße, ein Land oder eine politische Einheit. Das types-Array in der Klasse google.maps.places.AddressComponent gibt den Typ der einzelnen Adressteile 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 für Adresskomponententypen 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 2 Hauptstraßen. |
political |
Eine politische Einheit. Normalerweise zeigt dieser Typ ein Polygon an, das einer öffentlichen Verwaltungseinheit entspricht. |
country |
Die staatliche politische Einheit (Land) ist normalerweise der Typ mit dem höchsten Rang, der vom Geocoder zurückgegeben wird. |
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 |
Eine gängige alternative Bezeichnung für die Einheit. |
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, normalerweise ein Gebäude oder ein Komplex von Gebäuden mit einem gemeinsamen Namen. |
subpremise |
Eine adressierbare Einheit unterhalb der Gebäudeebene, z. B. eine Wohnung, eine Einheit oder ein Apartment. |
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 auffälliges 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.
| Typ der Adresskomponente | Beschreibung |
|---|---|
floor |
Das Stockwerk einer Gebäudeadresse. |
establishment |
Normalerweise 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 |
Ein bestimmter Briefkasten. |
postal_town |
Eine Gruppe geografischer Gebiete wie locality und sublocality, die in einigen Ländern als Postanschriften verwendet werden. |
room |
Der Raum innerhalb einer Gebäudeadresse. |
street_number |
Die genaue Hausnummer. |
bus_station, train_station und transit_station |
Der Standort einer Bus-, Bahn- oder ÖPNV-Haltestelle. |