Ortstypen (neu)

Ortstypen sind Kategorien, die die Eigenschaften eines Orts angeben. Einem Ort kann 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:

• Einem Ort kann ein einzelner primärer Typ aus Tabelle A oder Tabelle B zugeordnet sein. Der primäre Typ kann beispielsweise mexican_restaurant oder steak_house sein.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 Feld types.
• 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. Beispielsweise kann eine Adresse als street_address und eine Komponente der Adresse als street_number gekennzeichnet 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.

Sie müssen die Places API (New) in Ihrem Google Cloud-Projekt aktivieren, um auf diese Typen zuzugreifen. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.

Typentabellen

In Tabelle A werden die Typen aufgeführt, die auf folgende Weise verwendet werden:

• Im Rahmen einer Antwort von „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ werden die Werte in Tabelle A verwendet, um das Attribut „types“ der GMSPlace-Instanz zu füllen. In der Anfrage muss GMSPlacePropertyTypes in der Feldliste angegeben werden.
• Im Rahmen einer „Nearby Search (New)“-Anfrage als Wert des Parameters „included types“, „excluded types“, „included primary types“ und „excluded primary types“.
• Im Rahmen einer „Text Search (New)“-Anfrage als Wert des enthaltenen Typparameters.
• Im Rahmen einer „Place Autocomplete (New)“-Anfrage als Werte des Parameters „types“.
• Im Rahmen einer „Place Autocomplete (New)“-Antwort, die zum Ausfüllen des Attributs „types“ der GMSAutocompletePlaceSuggestion-Instanz verwendet wird.

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 (New)“-Antwort zurückgegeben werden können. In der Anfrage muss GMSPlacePropertyTypes in der Feldliste angegeben werden. Werte aus Tabelle B dürfen NICHT als Teil einer Anfrage verwendet werden, außer als Werte für den Parameter „types“ für eine „Place Autocomplete (New)“-Anfrage.

Unter Typen von Adressen und Adresskomponenten finden Sie eine Liste der Typen, die im Antworttext entweder im Array für den Adresstyp oder im Array für den Adresskomponententyp oder in beiden Arrays enthalten sein können. Die Typen von Adresskomponenten können sich ändern.

Tabelle A

Automobil Unternehmen Kultur Bildung Unterhaltung und Freizeit Einrichtungen * Google Finanzen Essen und Trinken Regionen Behörden

Gesundheit und Wohlbefinden Gehäuse * Unterkunft Natürliche Merkmale * Religiöse Orte Dienstleister Shopping Sporteinrichtungen Transportwesen

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 Autocomplete (New)-Anfragen 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-Enum in der GMSPlace-Klasse in der Antwort gibt den Adresstyp an. Beispiele für Adresstypen sind eine Straße, ein Land oder eine politische Einheit. Das types-Array im GMSAddressComponent-Objekt 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 zwei 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 oder ein Büro.
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.