Typy miejsc (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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_restaurant lub steak_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 polu types.
  • 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 – tagiem street_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.types lub places.primaryType w 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, includedPrimaryTypes i excludedPrimaryTypes. 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_dealer
car_rental
car_repair
car_wash
ebike_charging_station *
electric_vehicle_charging_station
gas_station
parking
parking_garage *
parking_lot *
rest_stop
tire_shop *
truck_dealer *
Firma
business_center *
corporate_office
coworking_space *
farm
manufacturer *
ranch
supplier *
television_studio *
Kultura
art_gallery
art_museum *
art_studio
auditorium
castle *
cultural_landmark
fountain *
historical_place
history_museum *
monument
museum
performing_arts_theater
sculpture
Edukacja
academic_department *
educational_institution *
library
preschool
primary_school
research_institute *
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
city_park *
comedy_club
community_center
concert_hall
convention_center
cultural_center
cycling_park
dance_hall
dog_park
event_venue
ferris_wheel
garden
go_karting_venue *
hiking_area
historical_landmark
indoor_playground *
internet_cafe
karaoke
live_music_venue *
marina
miniature_golf_course *
movie_rental
movie_theater
national_park
night_club
observation_deck
off_roading_area
opera_house
paintball_center *
park
philharmonic_hall
picnic_ground
planetarium
plaza
roller_coaster
skateboard_park
state_park
tourist_attraction
video_arcade
vineyard *
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
argentinian_restaurant *
asian_fusion_restaurant *
asian_restaurant
australian_restaurant *
austrian_restaurant *
bagel_shop
bakery
bangladeshi_restaurant *
bar
bar_and_grill
barbecue_restaurant
basque_restaurant *
bavarian_restaurant *
beer_garden *
belgian_restaurant *
bistro *
brazilian_restaurant
breakfast_restaurant
brewery *
brewpub *
british_restaurant *
brunch_restaurant
buffet_restaurant
burmese_restaurant *
burrito_restaurant *
cafe
cafeteria
cajun_restaurant *
cake_shop *
californian_restaurant *
cambodian_restaurant *
candy_store
cantonese_restaurant *
caribbean_restaurant *
cat_cafe
chicken_restaurant *
chicken_wings_restaurant *
chilean_restaurant *
chinese_noodle_restaurant *
chinese_restaurant
chocolate_factory
chocolate_shop
cocktail_bar *
coffee_roastery *
coffee_shop
coffee_stand *
colombian_restaurant *
confectionery
croatian_restaurant *
cuban_restaurant *
czech_restaurant *
danish_restaurant *
deli
dessert_restaurant
dessert_shop
dim_sum_restaurant *
diner
dog_cafe
donut_shop
dumpling_restaurant *
dutch_restaurant *
eastern_european_restaurant *
ethiopian_restaurant *
european_restaurant *
falafel_restaurant *
family_restaurant *
fast_food_restaurant
filipino_restaurant *
fine_dining_restaurant
fish_and_chips_restaurant *
fondue_restaurant *
food_court
french_restaurant
fusion_restaurant *
gastropub *
german_restaurant *
greek_restaurant
gyro_restaurant *
halal_restaurant*
hamburger_restaurant
hawaiian_restaurant *
hookah_bar *
hot_dog_restaurant *
hot_dog_stand *
hot_pot_restaurant *
hungarian_restaurant *
ice_cream_shop
indian_restaurant
indonesian_restaurant
irish_pub *
irish_restaurant *
israeli_restaurant *
italian_restaurant
japanese_curry_restaurant *
japanese_izakaya_restaurant *
japanese_restaurant
juice_shop
kebab_shop *
korean_barbecue_restaurant *
korean_restaurant
latin_american_restaurant *
lebanese_restaurant
lounge_bar *
malaysian_restaurant *
meal_delivery
meal_takeaway
mediterranean_restaurant
mexican_restaurant
middle_eastern_restaurant
mongolian_barbecue_restaurant *
moroccan_restaurant *
noodle_shop *
north_indian_restaurant *
oyster_bar_restaurant *
pakistani_restaurant *
pastry_shop *
persian_restaurant *
peruvian_restaurant *
pizza_delivery *
pizza_restaurant
polish_restaurant *
portuguese_restaurant *
pub
ramen_restaurant
restaurant
romanian_restaurant *
russian_restaurant *
salad_shop *
sandwich_shop
scandinavian_restaurant *
seafood_restaurant
shawarma_restaurant *
snack_bar *
soul_food_restaurant *
soup_restaurant *
south_american_restaurant *
south_indian_restaurant *
southwestern_us_restaurant *
spanish_restaurant
sports_bar *
sri_lankan_restaurant *
steak_house
sushi_restaurant
swiss_restaurant *
taco_restaurant *
taiwanese_restaurant *
tapas_restaurant *
tea_house
tex_mex_restaurant *
thai_restaurant
tibetan_restaurant *
tonkatsu_restaurant *
turkish_restaurant
ukrainian_restaurant *
vegan_restaurant
vegetarian_restaurant
vietnamese_restaurant
western_restaurant *
wine_bar
winery *
yakiniku_restaurant *
yakitori_restaurant *
Obszary geograficzne
administrative_area_level_1
administrative_area_level_2
country
locality
postal_code
school_district
Administracja państwowa
city_hall
courthouse
embassy
fire_station
government_office
local_government_office
neighborhood_police_station (tylko Japonia)
police
post_office
Zdrowie i dobre samopoczucie
chiropractor
dental_clinic
dentist
doctor
drugstore
general_hospital *
hospital
massage
massage_spa *
medical_center *
medical_clinic *
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
Obiekty naturalne
beach
island *
lake *
mountain_peak *
nature_preserve *
river *
scenic_spot *
woods *
Miejsca kultu
buddhist_temple *
church
hindu_temple
mosque
shinto_shrine *
synagogue
Usługi
aircraft_rental_service *
association_or_organization *
astrologer
barber_shop
beautician
beauty_salon
body_art_service
catering_service
cemetery
chauffeur_service *
child_care_agency
consultant
courier_service
electrician
employment_agency *
florist
food_delivery
foot_care
funeral_home
hair_care
hair_salon
insurance_agency
laundry
lawyer
locksmith
makeup_artist
marketing_consultant *
moving_company
nail_salon
non_profit_organization *
painter
pet_boarding_service *
pet_care *
plumber
psychic
real_estate_agency
roofing_contractor
service *
shipping_service *
storage
summer_camp_organizer
tailor
telecommunications_service_provider
tour_agency
tourist_information_center
travel_agency
veterinary_care
Zakupy
asian_grocery_store
auto_parts_store
bicycle_store
book_store
building_materials_store *
butcher_shop
cell_phone_store
clothing_store
convenience_store
cosmetics_store *
department_store
discount_store
discount_supermarket *
electronics_store
farmers_market *
flea_market *
food_store
furniture_store
garden_center *
general_store *
gift_shop
grocery_store
hardware_store
health_food_store *
home_goods_store
home_improvement_store
hypermarket *
jewelry_store
liquor_store
market
pet_store
shoe_store
shopping_mall
sporting_goods_store
sportswear_store *
store
supermarket
tea_store *
thrift_store *
toy_store *
warehouse_store
wholesaler
womens_clothing_store *
Sport
arena
athletic_field
fishing_charter
fishing_pier *
fishing_pond
fitness_center
golf_course
gym
ice_skating_rink
indoor_golf_course *
playground
race_course *
ski_resort
sports_activity_location
sports_club
sports_coaching
sports_complex
sports_school *
stadium
swimming_pool *
tennis_court *
Transport
airport
airstrip
bike_sharing_station *
bridge *
bus_station
bus_stop
ferry_service *
ferry_terminal
heliport
international_airport
light_rail_station
park_and_ride
subway_station
taxi_service *
taxi_stand
toll_station *
train_station
train_ticket_office *
tram_stop *
transit_depot
transit_station
transit_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_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

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.