Wprowadzenie
Typy miejsc to kategorie, które określają cechy miejsca. Miejsce może mieć przypisany co najmniej 1 typ.
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 typ jest określony w żądaniu, 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ę typów używanych w następujący sposób:
- W ramach odpowiedzi z Place Details (New), Nearby Search (New) i Text Search (New). Żądanie musi zawierać co najmniej 1 z pól places.typeslubplaces.primaryTypew masce pola. 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 Autocomplete (New) użyj jako wartości parametru includedPrimaryTypes.
- W ramach odpowiedzi Autouzupełnianie (nowe).
Tabela B zawiera dodatkowe wartości typu miejsca, które mogą być też zwracane w odpowiedziach na zapytania o szczegóły miejsca (nowe), wyszukiwanie w pobliżu (nowe), wyszukiwanie tekstowe (nowe) i autouzupełnianie (nowe). W masce pola żądania musi być określone co najmniej jedno z pól places.types lub places.primaryType. Wartości z tabeli B NIE mogą być używane w żądaniu, z wyjątkiem wartości parametru includedPrimaryTypes w żądaniu autouzupełniania (nowego).
Typy adresów i typy komponentów adresu listy typów, które mogą występować w tablicach typów adresów i 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 w Japonii)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 z informacjami o miejscu (nowe), wyszukiwania w pobliżu (nowe), wyszukiwania tekstowego (nowe) lub autouzupełniania (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 polu 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 typów adresów i typów komponentów 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 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_1krótkie nazwy będą ściśle odpowiadać podziałom ISO 3166-2 i innym powszechnie używanym 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 mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. | 
| administrative_area_level_4 | Jednostka administracyjna czwartego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszy podział administracyjny. 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 mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. | 
| administrative_area_level_6 | Jednostka administracyjna szóstego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszy podział administracyjny. Nie wszystkie kraje mają te poziomy administracyjne. | 
| administrative_area_level_7 | Jednostka administracyjna siódmego rzędu poniżej poziomu kraju. Ten typ wskazuje na mniejszy podział administracyjny. 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 poziomu 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 budynku, 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 ważne 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 | Określona skrytka pocztowa. | 
| postal_town | Grupa obszarów geograficznych, np. localityisublocality, używana w adresach pocztowych w niektórych krajach. | 
| room | Pokój w adresie budynku. | 
| street_number | Dokładny numer ulicy. | 
| bus_station,train_stationitransit_station | Lokalizacja przystanku autobusowego, kolejowego lub komunikacji miejskiej. |