Typy miejsc (nowość)

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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_restaurant lub steak_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 polu types.
  • 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ęść jako street_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.

Aby uzyskać dostęp do tych typów, musisz włączyć Places API (New) w projekcie Google Cloud. Więcej informacji znajdziesz w artykule Konfigurowanie projektu Google Cloud.

Informacje o tabelach typów

Tabela A zawiera listę typów używanych w następujący sposób:

  • W ramach odpowiedzi z usługi Place Details (New), Nearby Search (New) i Text Search (New) wartości z tabeli A są używane do wypełniania właściwości types instancji GMSPlace. Żądanie musi zawierać pole GMSPlacePropertyTypes na liście pól.
  • W ramach żądania wyszukiwania w pobliżu (nowego) używany jako wartość parametrów included types, excluded types, included primary types i excluded primary types.
  • W ramach żądania wyszukiwania tekstowego (nowego) używany jako wartość parametru type.
  • W ramach żądania autouzupełniania miejsc (nowego) użyj jako wartości parametru types.
  • W ramach odpowiedzi autouzupełniania miejsc (nowego) używanej do wypełniania właściwości typów instancji GMSAutocompletePlaceSuggestion.

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 autouzupełnianiem miejsc (nowe). Żądanie musi zawierać GMSPlacePropertyTypes na liście pól. Wartości z tabeli B NIE mogą być używane w żądaniu, z wyjątkiem wartości parametru types w żądaniu autouzupełniania miejsca (nowego).

Typy adresów i typy komponentów adresu to lista typów, 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_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 Japonia)
police
post_office
Zdrowie i dobre samopoczucie
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
Obiekty 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
Zakupy
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

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 komponentów adresu

Wyliczenie types w klasie GMSPlace w odpowiedzi wskazuje typ adresu. Przykłady typów adresów to adres ulicy, kraj lub jednostka polityczna. Tablica types w obiekcie GMSAddressComponent 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 szóstego 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 siódmego 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.