Wprowadzenie
Typy miejsc to kategorie, które określają cechy miejsca. Do miejsca może być przypisany co najmniej 1 typ.
Typy miejsca są uwzględniane w odpowiedzi na żądanie dotyczące informacji o miejscu (nowych), wyszukiwania w pobliżu (nowego), wyszukiwania tekstowego (nowego) i autouzupełniania (nowego):
- Miejsce może mieć jeden główny typ z tabeli A lub tabeli B.
Na przykład typ główny może mieć wartość
mexican_restaurantlubsteak_house. Typ główny może być nieobecny, jeśli typ główny miejsca nie jest obsługiwany. Jeśli typ podstawowy jest obecny, zawsze jest jednym z typów w polutypes. - Z miejscem może być powiązanych 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 elementy składowe mogą być oznaczone określonymi typami z tabeli Typy adresów i typów elementów składowych adresu. Na przykład adres może być oznaczony tagiem
street_address, a jego element – tagiemstreet_number.
Możesz też określić typy miejsc w ramach żądania. Jeśli typ jest określony w żądaniu, działa on jako filtr, który ogranicza odpowiedź tylko do miejsc pasujących do określonych typów.
Informacje o tabelach typów
Tabela A zawiera listę typów, które są używane w następujący sposób:
- jako część odpowiedzi z informacji o miejscu (nowych), wyszukiwania w pobliżu (nowego) i wyszukiwania tekstowego (nowego). Żądanie musi określać co najmniej jedno 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 żądania wyszukiwania w pobliżu (nowego) używana 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żywanego jako wartość parametru
includedType. - W żądaniu Autouzupełniania (nowego) użyj jako wartości parametru
includedPrimaryTypes. - W ramach odpowiedzi Autouzupełniania (nowego).
Tabela B zawiera dodatkowe wartości typów miejsc, które mogą być zwracane w odpowiedziach na zapytania o informacje o miejscu (nowe), Wyszukiwanie w pobliżu (nowe), Wyszukaj tekst (nowe) i autouzupełnianie (nowe). Żądanie musi określać 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 Autouzupełniania (nowego).
Tabela C zawiera kolekcje typów, których można używać jako wartości parametru includedPrimaryTypes w żądaniu Autouzupełniania (nowego). Kolekcji typów nie można określać za pomocą żadnych innych wartości typów.
Typy adresów i typy komponentów adresów zawierają listę typów, które mogą pojawiać się w tablicach typów adresów lub typów komponentów adresów w treści odpowiedzi. Typy komponentów adresu mogą ulec zmianie.
Tabela A
| Motoryzacja | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| Firma | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| Kultura | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| Edukacja | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| Rozrywka i rekreacja | ||
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
|
| Wyposażenie | ||
public_bathpublic_bathroomstable
|
||
| Finanse | ||
accountingatmbank
|
||
| Żywność i napoje | ||
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 * |
| Obszary geograficzne | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Administracja państwowa | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station (tylko Japonia)policepost_office
|
|
| Zdrowie i dobre samopoczucie | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| Nieruchomości | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| Zakwaterowanie | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| Obiekty naturalne | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| Miejsca kultu | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| Usługi | ||
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
|
|
| Zakupy | ||
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
|
|
Tabela B
Wartości typów miejsc w tabeli B mogą być zwracane w odpowiedziach na zapytania o informacje o miejscu (nowa wersja), Wyszukiwanie w pobliżu (nowa wersja), Wyszukaj tekst (nowa wersja) lub autouzupełnianie (nowa wersja). Te typy są też obsługiwane przez includedPrimaryTypes w przypadku żądań autouzupełniania (nowego).
| 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
|
|
Tabela C
Kolekcje typów mogą być używane jako wartość includedPrimaryTypes w żądaniach autouzupełniania (nowego). Użycie kolekcji typów zwraca wszystkie wyniki, które pasują do dowolnego z powiązanych typów uwzględnionych. Kolekcji typów nie można określać za pomocą innych wartości typu.
| Kolekcja typów | Uwzględnione typy |
|---|---|
(regions) |
Filtry dotyczące obszarów lub podziałów, takich jak dzielnice i kody pocztowe. |
(cities) |
Filtruje miejsca, które Google identyfikuje jako miasto. |
Typy adresów i typy komponentów adresu
Tablica types w odpowiedzi wskazuje typ adresu. Przykłady typów adresów to adres, kraj lub podmiot polityczny. Tablica types w polu AddressComponent wskazuje typ każdej części adresu. Przykłady: numer domu lub kraj.
Adresy mogą mieć wiele typów. Typy można traktować jako „tagi”.
Na przykład wiele miast jest oznaczonych typami political i locality.
Następujące typy są obsługiwane i zwracane zarówno w tablicach typów adresów, jak i typów komponentów adresów:
| 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 jakiejś administracji cywilnej. |
country |
Narodowy podmiot polityczny, zwykle najwyższy poziom 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 używają tych poziomów administracyjnych. W większości przypadków krótkie nazwy administrative_area_level_1 będą ściśle odpowiadać podregionom ISO 3166-2 i innym powszechnie używanym listom. Nie możemy jednak tego zagwarantować, 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 używają tych poziomów administracyjnych. |
administrative_area_level_3 |
Jednostka administracyjna trzeciego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych. |
administrative_area_level_4 |
Jednostka administracyjna czwartego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych. |
administrative_area_level_5 |
Jednostka administracyjna piątego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych. |
administrative_area_level_6 |
Jednostka administracyjna szóstego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych. |
administrative_area_level_7 |
Jednostka administracyjna siódmego rzędu poniżej poziomu kraju. Ten typ wskazuje mniejszą jednostkę administracyjną. Nie wszystkie kraje używają tych poziomów administracyjnych. |
colloquial_area |
Powszechnie używana alternatywna nazwa podmiotu. |
locality |
Podmiot polityczny miasta lub miasteczka. |
sublocality |
Jednostka administracyjna pierwszego rzędu poniżej miejscowości. W przypadku niektórych lokalizacji możesz otrzymać jeden z dodatkowych typów: od sublocality_level_1 do sublocality_level_5. Każdy poziom dzielnicy jest jednostką administracyjną. Im większa liczba, tym mniejszy obszar geograficzny. |
neighborhood |
Nazwana okolica. |
premise |
Nazwana lokalizacja, zwykle budynek lub zbiór budynków o wspólnej nazwie. |
subpremise |
Jednostka adresowa poniżej poziomu budynku, np. mieszkanie, lokal lub apartament. |
plus_code |
Zakodowane odniesienie do lokalizacji, uzyskane na podstawie szerokości i długości geograficznej. Kodów Plus można używać zamiast adresów ulic w miejscach, gdzie nie ma adresów (gdzie budynki nie są ponumerowane lub ulice nie mają nazw). Więcej informacji znajdziesz na stronie https://plus.codes. |
postal_code |
Kod pocztowy używany do adresowania przesyłek pocztowych na terenie danego kraju. |
natural_feature |
Wyrazisty obiekt naturalny. |
airport |
Lotnisko. |
park |
Park z nazwą. |
point_of_interest |
Nazwane ciekawe miejsce. Zazwyczaj są to znane lokalne obiekty, które nie pasują do żadnej innej kategorii, np. „Pałac Kultury i Nauki” czy „Wieża Eiffla”. |
Pusta lista typów oznacza, że nie ma znanych typów dla danego komponentu adresu (np. Lieu-dit we Francji).
Oprócz powyższych komponenty adresu mogą zawierać 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 ułatwiający nawigację. |
point_of_interest |
Nazwane ciekawe miejsce. |
parking |
Parking lub zadaszony parking. |
post_box |
konkretną skrytkę pocztową, |
postal_town |
Grupa obszarów geograficznych, takich jak locality i sublocality, używana w adresach pocztowych w niektórych krajach. |
room |
Pokój w adresie budynku. |
street_number |
Dokładny numer domu. |
bus_station, train_station i transit_station |
Lokalizacja przystanku autobusowego, kolejowego lub transportu publicznego. |