Typy miejsc to kategorie, które określają cechy miejsca. Miejscu może być przypisany co najmniej 1 typ miejsca.
Typy miejsc są uwzględniane w odpowiedzi na żądanie dotyczące szczegółów miejsca (nowa), wyszukiwania w pobliżu (nowa), wyszukiwania tekstowego (nowa) i autouzupełniania miejsc (nowa):
- Miejsce może mieć jeden podstawowy typ z typu Tabela A lub Tabela B powiązane z tym miejscem.
Na przykład główny typ może być
mexican_restaurant
lubsteak_house
. - Miejsce może mieć wiele wartości typu z typu Tabela A lub typu Tabela B powiązanego z tym miejscem.
Na przykład restauracja może mieć te typy:
seafood_restaurant
,restaurant
,food
,point_of_interest
,establishment
. - Adres i jego elementy mogą być oznaczone określonymi typami z tabeli Typy adresów i elementów adresu. Na przykład adres może być oznaczony jako
street_address
, a jego element jakostreet_number
.
Typy miejsc możesz też określić w ramach żądania. Gdy typ jest określony w żądaniu, działa on jako filtr, który ogranicza odpowiedź do uwzględnienia tylko miejsc pasujących do określonych typów.
Tabele typów
Tabela A zawiera typy używane w następujący sposób:
- W ramach odpowiedzi z usług Szczegóły miejsca (Nowa),
Szukaj w pobliżu (Nowa) i
Szukaj w tekście (Nowa). W żądaniu musisz podać co najmniej jedno z pol
places.types
lubplaces.primaryType
w masce pola. Następnie do wypełniania tych pól używane są wartości z tabeli A. - W ramach prośby o wyszukiwanie w pobliżu (nowej) jest używany jako wartość parametru
includedTypes
,excludedTypes
,includedPrimaryTypes
lubexcludedPrimaryTypes
. Następnie wartości z tabeli B są używane do wypełniania tych pól. - W ramach żądania wyszukiwania tekstowego (nowego) służy do podawania wartości parametru
includedType
. - W ramach żądania Autocomplete (New) użyj tych wartości jako wartości parametru
includedPrimaryTypes
. - W ramach odpowiedzi „Autouzupełnianie (nowa)”.
Tabela B zawiera dodatkowe wartości typu miejsca, które mogą być zwracane w odpowiedziach na żądania Szczegóły miejsca (Nowość), Wyszukaj w pobliżu (Nowość), Wyszukaj tekst (Nowość) i Autouzupełnianie (Nowość). W żądaniu musisz określić co najmniej 1 pole places.types
lub places.primaryType
w masce pola. Wartości z tabeli B NIE mogą być używane w ramach żądania, z wyjątkiem wartości parametru includedPrimaryTypes
w żądaniu Autocomplete (New).
Typy adresów i typy elementów adresu to typy, które mogą się pojawiać w tablicach typów adresów lub tablicach typów elementów adresu w ciele odpowiedzi. Typy elementów adresu mogą ulec zmianie.
Tabela A
Motoryzacja | ||
---|---|---|
car_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
Firma | ||
corporate_office *farm ranch * |
||
Kultura | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Edukacja | ||
library preschool primary_school
|
school secondary_school university
|
|
Rozrywka i rekreacja | ||
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
|
Wyposażenie | ||
public_bath *public_bathroom *stable *
|
||
Finanse | ||
accounting atm bank
|
||
Żywność i napoje | ||
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 *
|
Obszary geograficzne | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Administracja publiczna | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (tylko w Japonii)police post_office
|
|
Zdrowie i wellness | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Nieruchomości | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Zakwaterowanie | ||
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
|
|
Elementy naturalne | ||
beach *
|
||
Miejsca kultu | ||
church hindu_temple mosque synagogue
|
||
Usługi | ||
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
|
|
kampania produktowa. | ||
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
|
Tabela B
Wartości typu Miejsce w tabeli B mogą być zwracane w ramach odpowiedzi na zapytanie dotyczące szczegółów miejsca (nowa), wyszukiwania w pobliżu (nowa), wyszukiwania tekstowego (nowa) lub autouzupełniania (nowa). Te typy są obsługiwane przez includedPrimaryTypes
w przypadku żądań autouzupełniania (Nowy).
Dodatkowe wartości typu miejsca | ||
---|---|---|
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
|
Typy adresów i typy elementów adresu
Tablica types
w odpowiedzi wskazuje typ adresu. Przykłady typów adresów to adres ulicy, kraj lub podmiot polityczny. Tablica types
w polu AddressComponent
wskazuje typ każdej części adresu. Przykłady: numer domu lub kraj.
Adresy mogą być różnego typu. Typy mogą być uznawane za „tagi”.
Na przykład wiele miast ma tagi typu political
i locality
.
W tablicach typów adresów i typów komponentów adresu obsługiwane są i zwracane są te typy:
Typ adresu | Opis |
---|---|
street_address |
Dokładny adres. |
route |
Nazwana trasa (np. „US 101”). |
intersection |
Główne skrzyżowanie, zwykle 2 głównych dróg. |
political |
podmiot polityczny, Zwykle ten typ wskazuje wielokąt administracyjny. |
country |
Narodowy podmiot polityczny, zwykle najwyższy typ zwracany przez geokoder. |
administrative_area_level_1 |
Jednostka administracyjna pierwszego rzędu poniżej poziomu kraju. W Stanach Zjednoczonych są to stany. Nie wszystkie kraje mają te poziomy administracyjne. W większości przypadków administrative_area_level_1 krótkie nazwy będą bardzo zbliżone do podziałów ISO 3166-2 i innych powszechnie rozpowszechnionych list, ale nie jest to gwarantowane, ponieważ nasze wyniki geokodowania opierają się na różnych sygnałach i danych o lokalizacji. |
administrative_area_level_2 |
Podmiot prawny drugiego rzędu na poziomie niższym niż kraj. W Stanach Zjednoczonych są to hrabstwa. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_3 |
Podmiot prawny trzeciego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_4 |
Czwarta jednostka cywilna poniżej poziomu kraju. Ten typ wskazuje mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_5 |
Podmiot prawny piątego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_6 |
Podmiot prawny szóstego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_7 |
Podmiot prawny siódmego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. |
colloquial_area |
powszechnie używana nazwa alternatywna, |
locality |
Ustanowiona jednostka polityczna, np. miasto. |
sublocality |
Jednostka administracyjna pierwszego rzędu poniżej lokalizacji. W przypadku niektórych lokalizacji może być używany jeden z dodatkowych typów: sublocality_level_1 do sublocality_level_5 . Każdy poziom podregionu jest jednostką administracyjną. Większe liczby oznaczają mniejszy obszar geograficzny. |
neighborhood |
Nazwana okolica. |
premise |
Nazwane miejsce, zwykle budynek lub zbiór budynków o wspólnej nazwie. |
subpremise |
Adresowalna jednostka poniżej poziomu obiektu, np. mieszkanie, lokal lub apartament. |
plus_code |
zakodowany identyfikator lokalizacji, który jest wyprowadzony ze współrzędnych szerokości i długości geograficznej; Kody Plus Code mogą zastępować adresy ulicy w miejscach, w których ich nie ma (gdzie budynki nie mają numerów, a ulice nazw). Więcej informacji znajdziesz na stronie https://plus.codes. |
postal_code |
Kod pocztowy służący do adresowania przesyłek pocztowych na terenie danego kraju. |
natural_feature |
Wyraźna cecha przyrodnicza. |
airport |
Lotnisko. |
park |
Park o nazwie. |
point_of_interest |
Nazwa interesującego miejsca. Zwykle są to znane obiekty lokalne, które nie pasują do żadnej innej kategorii, np. Pałac Kultury i Nauki w Warszawie czy Wieża Eiffla. |
Pusta lista typów wskazuje, że nie ma żadnych znanych typów dla danego elementu adresu (np. Lieu-dit we Francji).
Oprócz wymienionych powyżej elementy adresu mogą obejmować typy wymienione poniżej.
Typ elementu adresu | Opis |
---|---|
floor |
Piętro w adresie budynku. |
establishment |
Zwykle jest to miejsce, które nie zostało jeszcze skategoryzowane. |
landmark |
Miejsce w pobliżu, które służy jako punkt odniesienia, aby ułatwić nawigację. |
point_of_interest |
Nazwa interesującego miejsca. |
parking |
Parking lub parkingowy budynek. |
post_box |
Określona skrzynka pocztowa. |
postal_town |
Grupa obszarów geograficznych, takich jak locality i sublocality , używana do adresów pocztowych w niektórych krajach. |
room |
Pokój w adresie budynku. |
street_number |
Dokładny numer budynku. |
bus_station , train_station i transit_station |
lokalizacja przystanku autobusowego, kolejowego lub przystanku komunikacji miejskiej; |