Typy miejsc to kategorie, które określają cechy miejsca. Miejsce może mieć przypisany co najmniej 1 typ miejsca.
Rodzaje miejsca są uwzględniane w odpowiedzi na żądanie szczegółów miejsca (nowe), wyszukiwania w pobliżu (nowe), wyszukiwania tekstowego (nowe) i autouzupełniania (nowe):
- Miejsce może mieć przypisany jeden typ podstawowy z tabeli A lub B.
Na przykład główny typ może być
mexican_restaurantlubsteak_house.Główny typ może być nieobecny, jeśli główny typ miejsca nie jest obsługiwany. Gdy występuje typ podstawowy, jest on zawsze jednym z typów w polutypes. - Miejsce może mieć wiele wartości typu z tabeli A lub tabeli B.
Na przykład restauracja może mieć te typy:
seafood_restaurant,restaurant,food,point_of_interest,establishment. - Adres i jego komponenty można oznaczyć określonymi typami z tabeli Typy adresów i komponentów adresu. Na przykład adres może być oznaczony jako
street_address, a jego część jakostreet_number.
W prośbie możesz też określić typy miejsc. Jeśli ten parametr zostanie określony w żądaniu, będzie działać jako filtr ograniczający odpowiedź tylko do miejsc, które pasują do określonych typów.
Informacje o tabelach typów
Tabela A zawiera listę obsługiwanych wartości typów miejsc:
- W ramach odpowiedzi z Place Details (New), Nearby Search (New) i Text Search (New). Wartości z tabeli A są następnie używane do wypełniania tych pól.
- W ramach prośby o wyszukiwanie w pobliżu (nowe) używane jako wartość parametrów
includedTypes,excludedTypes,includedPrimaryTypesiexcludedPrimaryTypes. Wartości z tabeli B są następnie używane do wypełniania tych pól. - W ramach żądania wyszukiwania tekstowego (nowego) używany jako wartość parametru
includedType. - W ramach żądania widżetu autouzupełniania miejsc (nowego) użyj jako wartości parametru
includedPrimaryTypes. - W ramach odpowiedzi widżetu autouzupełniania miejsc (nowego).
Tabela B zawiera dodatkowe wartości typu miejsca, które mogą być też zwracane w ramach odpowiedzi z informacjami o miejscu (nowe), wyszukiwaniem w pobliżu (nowe), wyszukiwaniem tekstowym (nowe) i widżetem autouzupełniania miejsc (nowym). Żądanie musi zawierać co najmniej jedno z pól places.types lub places.primaryType w masce pola.
Wartości z tabeli B NIE mogą być używane w żądaniu, z wyjątkiem wartości parametru includedPrimaryTypes w żądaniu dotyczącym widżetu autouzupełniania miejsca (nowego).
Typy adresów i typy komponentów adresu to typy list, które mogą występować w tablicach typów adresów lub typów komponentów adresu w treści odpowiedzi. Typy komponentów adresu mogą ulec zmianie.
Tabela A
| Motoryzacja | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| Firma | ||
corporate_office *farmranch * |
||
| Kultura | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| Edukacja | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| Rozrywka i rekreacja | ||
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
|
| Wyposażenie | ||
public_bath *public_bathroom *stable *
|
||
| Finanse | ||
accountingatmbank
|
||
| Żywność i napoje | ||
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 *
|
| Obszary geograficzne | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Administracja publiczna | ||
city_hallcourthouseembassyfire_stationgovernment_office *
|
local_government_officeneighborhood_police_station (tylko Japonia)policepost_office
|
|
| Zdrowie i dobre samopoczucie | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| Nieruchomości | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| Zakwaterowanie | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| Obiekty naturalne | ||
beach *
|
||
| Miejsca kultu | ||
churchhindu_templemosquesynagogue
|
||
| Usługi | ||
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
|
|
| Zakupy | ||
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
|
|
Tabela B
Wartości typu miejsca w tabeli B mogą być zwracane w ramach odpowiedzi na zapytanie o szczegóły miejsca (nowe), wyszukiwanie w pobliżu (nowe), wyszukiwanie tekstowe (nowe) lub autouzupełnianie (nowe). Te typy są też obsługiwane w przypadku żądań includedPrimaryTypes autouzupełniania (nowego)includedPrimaryTypes.
| Dodatkowe wartości typu miejsca | ||
|---|---|---|
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
|
|
Typy adresów i typy komponentów adresu
Tablica types w odpowiedzi wskazuje typ adresu. Przykłady typów adresów to adres ulicy, kraj lub jednostka polityczna. Tablica types w klasie google.maps.places.AddressComponent wskazuje typ każdej części adresu. Mogą to być np. numer ulicy lub kraj.
Adresy mogą mieć wiele typów. Typy te można uznać za „tagi”.
Na przykład wiele miast jest oznaczonych typami political i locality.
Obsługiwane są te typy, które są zwracane w tablicach typu adresu i typu komponentu adresu:
| Typ adresu | Opis |
|---|---|
street_address |
dokładny adres. |
route |
Nazwa trasy (np. „US 101”). |
intersection |
Główne skrzyżowanie, zwykle dwóch głównych dróg. |
political |
podmiot polityczny; Zwykle ten typ wskazuje wielokąt przedstawiający jakąś jednostkę administracji cywilnej. |
country |
Narodowy podmiot polityczny, zwykle typ najwyższego rzędu 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_1krótkie nazwy będą ściśle odpowiadać podziałom ISO 3166-2 i innym powszechnie rozpowszechnianym listom, ale nie jest to gwarantowane, ponieważ nasze wyniki geokodowania są oparte na różnych sygnałach i danych o lokalizacji. |
administrative_area_level_2 |
Jednostka administracyjna drugiego rzędu poniżej poziomu kraju. W Stanach Zjednoczonych są to hrabstwa. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_3 |
Jednostka administracyjna trzeciego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszą jednostkę podziału administracyjnego. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_4 |
Jednostka administracyjna czwartego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszą jednostkę podziału administracyjnego. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_5 |
Jednostka administracyjna piątego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszą jednostkę podziału administracyjnego. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_6 |
Jednostka administracyjna 6 rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszą jednostkę podziału administracyjnego. Nie wszystkie kraje mają te poziomy administracyjne. |
administrative_area_level_7 |
Jednostka administracyjna 7 rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszą jednostkę podziału administracyjnego. Nie wszystkie kraje mają te poziomy administracyjne. |
colloquial_area |
Powszechnie używana nazwa alternatywna elementu. |
locality |
podmiot polityczny w postaci miasta lub miejscowości; |
sublocality |
Jednostka administracyjna pierwszego rzędu poniżej miejscowości. W przypadku niektórych lokalizacji może być wyświetlany jeden z dodatkowych typów: sublocality_level_1–sublocality_level_5. Każdy poziom podlokalizacji jest jednostką administracyjną. Im większa liczba, tym mniejszy obszar geograficzny. |
neighborhood |
Nazwana okolica. |
premise |
Nazwana lokalizacja, zwykle budynek lub zespół budynków o wspólnej nazwie. |
subpremise |
Adresowalny obiekt poniżej poziomu lokalu, np. mieszkanie, lokal lub apartament. |
plus_code |
Zakodowany odnośnik do lokalizacji, który jest wyznaczany na podstawie szerokości i długości geograficznej. Kody Plus Code mogą zastępować adresy w miejscach, w których nie istnieją (gdzie budynki nie mają numerów lub ulice nie mają nazw). Więcej informacji znajdziesz na https://plus.codes. |
postal_code |
Kod pocztowy używany do adresowania przesyłek pocztowych na terenie danego kraju. |
natural_feature |
wyraźny obiekt naturalny, |
airport |
lotnisko, |
park |
Nazwany park. |
point_of_interest |
Nazwane ciekawe miejsce. Zazwyczaj są to znane lokalne obiekty, które nie pasują do żadnej innej kategorii, np. „Empire State Building” lub „Wieża Eiffla”. |
Pusta lista typów oznacza, że dla danego komponentu adresu nie ma znanych typów (np. Lieu-dit we Francji).
Oprócz powyższych komponenty 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 jest używane jako punkt odniesienia ułatwiający nawigację. |
point_of_interest |
Nazwane ciekawe miejsce. |
parking |
parking lub parking wielopoziomowy; |
post_box |
konkretną skrytkę pocztową. |
postal_town |
Grupa obszarów geograficznych, np. locality i sublocality, używana w adresach pocztowych w niektórych krajach. |
room |
Pokój w adresie budynku. |
street_number |
Dokładny numer ulicy. |
bus_station, train_station i transit_station |
Lokalizacja przystanku autobusowego, kolejowego lub komunikacji miejskiej. |