Einführung
Ortstypen sind Kategorien, die die Merkmale eines Ortes beschreiben. 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. Der primäre Typ fehlt möglicherweise, wenn der primäre Typ des Orts nicht unterstützt wird. 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 die Adresskomponenten eines Orts können mit bestimmten Typen aus der Tabelle Typen von Adressen und Adresskomponenten getaggt werden. Eine Adresse kann beispielsweise als
street_addressund eine Komponente der Adresse alsstreet_numbergetaggt werden.
Sie können Ortstypen auch als Teil einer Anfrage angeben. Wenn der Typ in der Anfrage angegeben ist, fungiert er als Filter, um die Antwort auf Orte zu beschränken, die den angegebenen Typen entsprechen.
Informationen zu den Typentabellen
In Tabelle A werden 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.typesoderplaces.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,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 „Autocomplete (New)“-Anfrage als Werte des Parameters
includedPrimaryTypes. - Im Rahmen einer Autocomplete (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 „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.
In Tabelle C sind Typensammlungen aufgeführt, die als Wert des Parameters includedPrimaryTypes in einer „Autocomplete (New)“-Anfrage verwendet werden können. Typensammlungen können nicht mit anderen Typwerten angegeben werden.
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. Adresskomponententypen können sich ändern.
Tabelle A
| Automobil | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| Unternehmen | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| Kultur | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| Bildung | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| Unterhaltung und Freizeit | ||
adventure_sports_centeramphitheatreamusement_centeramusement_parkaquariumbanquet_hallbarbecue_areabotanical_gardenbowling_alleycasinochildrens_campcity_park *comedy_clubcommunity_centerconcert_hallconvention_centercultural_centercycling_parkdance_halldog_parkevent_venueferris_wheelgardengo_karting_venue * |
hiking_areahistorical_landmarkindoor_playground *internet_cafekaraokelive_music_venue *marinaminiature_golf_course *movie_rentalmovie_theaternational_parknight_clubobservation_deckoff_roading_areaopera_housepaintball_center *parkphilharmonic_hallpicnic_groundplanetariumplazaroller_coasterskateboard_parkstate_park |
tourist_attractionvideo_arcadevineyard *visitor_centerwater_parkwedding_venuewildlife_parkwildlife_refugezoo
|
| Räumlichkeiten | ||
public_bathpublic_bathroomstable
|
||
| Finanzen | ||
accountingatmbank
|
||
| Essen und Trinken | ||
acai_shopafghani_restaurantafrican_restaurantamerican_restaurantargentinian_restaurant *asian_fusion_restaurant *asian_restaurantaustralian_restaurant *austrian_restaurant *bagel_shopbakerybangladeshi_restaurant *barbar_and_grillbarbecue_restaurantbasque_restaurant *bavarian_restaurant *beer_garden *belgian_restaurant *bistro *brazilian_restaurantbreakfast_restaurantbrewery *brewpub *british_restaurant *brunch_restaurantbuffet_restaurantburmese_restaurant *burrito_restaurant *cafecafeteriacajun_restaurant *cake_shop *californian_restaurant *cambodian_restaurant *candy_storecantonese_restaurant *caribbean_restaurant *cat_cafechicken_restaurant *chicken_wings_restaurant *chilean_restaurant *chinese_noodle_restaurant *chinese_restaurantchocolate_factorychocolate_shopcocktail_bar *coffee_roastery *coffee_shopcoffee_stand *colombian_restaurant *confectionerycroatian_restaurant *cuban_restaurant *czech_restaurant *danish_restaurant *deli |
dessert_restaurantdessert_shopdim_sum_restaurant *dinerdog_cafedonut_shopdumpling_restaurant *dutch_restaurant *eastern_european_restaurant *ethiopian_restaurant *european_restaurant *falafel_restaurant *family_restaurant *fast_food_restaurantfilipino_restaurant *fine_dining_restaurantfish_and_chips_restaurant *fondue_restaurant *food_courtfrench_restaurantfusion_restaurant *gastropub *german_restaurant *greek_restaurantgyro_restaurant *halal_restaurant* hamburger_restauranthawaiian_restaurant *hookah_bar *hot_dog_restaurant *hot_dog_stand *hot_pot_restaurant *hungarian_restaurant *ice_cream_shopindian_restaurantindonesian_restaurantirish_pub *irish_restaurant *israeli_restaurant *italian_restaurantjapanese_curry_restaurant *japanese_izakaya_restaurant *japanese_restaurantjuice_shopkebab_shop *korean_barbecue_restaurant *korean_restaurantlatin_american_restaurant *lebanese_restaurantlounge_bar *malaysian_restaurant *meal_deliverymeal_takeawaymediterranean_restaurantmexican_restaurantmiddle_eastern_restaurantmongolian_barbecue_restaurant * |
moroccan_restaurant *noodle_shop *north_indian_restaurant *oyster_bar_restaurant *pakistani_restaurant *pastry_shop *persian_restaurant *peruvian_restaurant *pizza_delivery *pizza_restaurantpolish_restaurant *portuguese_restaurant *pubramen_restaurantrestaurantromanian_restaurant *russian_restaurant *salad_shop *sandwich_shopscandinavian_restaurant *seafood_restaurantshawarma_restaurant *snack_bar *soul_food_restaurant *soup_restaurant *south_american_restaurant *south_indian_restaurant *southwestern_us_restaurant *spanish_restaurantsports_bar *sri_lankan_restaurant *steak_housesushi_restaurantswiss_restaurant *taco_restaurant *taiwanese_restaurant *tapas_restaurant *tea_housetex_mex_restaurant *thai_restauranttibetan_restaurant *tonkatsu_restaurant *turkish_restaurantukrainian_restaurant *vegan_restaurantvegetarian_restaurantvietnamese_restaurantwestern_restaurant *wine_barwinery *yakiniku_restaurant *yakitori_restaurant * |
| 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 | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| Wohnen | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| Unterkunft | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| Geografische Elemente | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| Religiöse Orte | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| Dienste | ||
aircraft_rental_service *association_or_organization *astrologerbarber_shopbeauticianbeauty_salonbody_art_servicecatering_servicecemeterychauffeur_service *child_care_agencyconsultantcourier_serviceelectricianemployment_agency *floristfood_deliveryfoot_carefuneral_homehair_carehair_saloninsurance_agencylaundrylawyerlocksmith |
makeup_artistmarketing_consultant *moving_companynail_salonnon_profit_organization *painterpet_boarding_service *pet_care *plumberpsychicreal_estate_agencyroofing_contractorservice *shipping_service *storagesummer_camp_organizertailortelecommunications_service_providertour_agencytourist_information_centertravel_agencyveterinary_care
|
|
| Shopping | ||
asian_grocery_storeauto_parts_storebicycle_storebook_storebuilding_materials_store *butcher_shopcell_phone_storeclothing_storeconvenience_storecosmetics_store *department_storediscount_storediscount_supermarket *electronics_storefarmers_market *flea_market *food_storefurniture_storegarden_center *general_store *gift_shopgrocery_storehardware_storehealth_food_store *home_goods_store
|
home_improvement_storehypermarket *jewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storesportswear_store *storesupermarkettea_store *thrift_store *toy_store *warehouse_storewholesalerwomens_clothing_store * |
|
| Sport | ||
arenaathletic_fieldfishing_charterfishing_pier *fishing_pondfitness_centergolf_coursegymice_skating_rinkindoor_golf_course * |
playgroundrace_course *ski_resortsports_activity_locationsports_clubsports_coachingsports_complexsports_school *stadiumswimming_pool *tennis_court * |
|
| Transport | ||
airportairstripbike_sharing_station *bridge *bus_stationbus_stopferry_service *ferry_terminalheliportinternational_airportlight_rail_stationpark_and_ride |
subway_stationtaxi_service *taxi_standtoll_station *train_stationtrain_ticket_office *tram_stop *transit_depottransit_stationtransit_stop *transportation_service *truck_stop
|
|
Tabelle B
Die Werte für den Ortstyp in Tabelle B können im Rahmen einer „Place Details (New)“-, „Nearby Search (New)“-, „Text Search (New)“- oder „Autocomplete (New)“-Antwort 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
|
|
Tabelle C
Typensammlungen können als includedPrimaryTypes-Wert in Autocomplete (New)-Anfragen verwendet werden. Wenn Sie eine Typsammlung verwenden, werden alle Ergebnisse zurückgegeben, die mit einem der zugehörigen eingeschlossenen Typen übereinstimmen. Typensammlungen können nicht mit anderen Typwerten angegeben werden.
| Sammlungstyp | Eingeschlossene Typen |
|---|---|
(regions) |
Filter für Gebiete oder Bereiche, z. B. Stadtteile und Postleitzahlen. |
(cities) |
Filtert nach Orten, die Google als Stadt identifiziert. |
Typen von Adressen und Adresskomponenten
Das types-Array in der Antwort gibt den Adresstyp an. Beispiele für Adresstypen sind eine Adresse, ein Land oder eine politische Einheit. Das types-Array im Feld AddressComponent gibt den Typ der einzelnen Adressbestandteile 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 im Array für den Adresstyp als auch im Array für den Adresskomponententyp 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 |
Gibt eine staatliche politische Einheit (Land) an und 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 administrative_area_level_1 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_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 Grundstücksebene, z. B. eine Wohnung, ein Apartment oder eine Suite. |
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 auffallendes 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 folgenden Typen enthalten.
| Typ der Adresskomponente | Beschreibung |
|---|---|
floor |
Das Stockwerk innerhalb 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 bestimmtes Postfach. |
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-, Zug- oder Haltestelle für öffentliche Verkehrsmittel. |