Tipi di luoghi

Seleziona la piattaforma:Android iOS JavaScript Servizio web

I tipi di luogo sono categorie che identificano le caratteristiche di un luogo. A un luogo possono essere assegnati uno o più tipi di luogo.

I tipi di un luogo sono inclusi nella risposta di una richiesta Place Details (New), Nearby Search (New), Text Search (New) e Autocomplete (New):

  • Un luogo può avere un unico tipo principale dal tipo Tabella A o dal tipo Tabella B associato. Ad esempio, il tipo principale potrebbe essere mexican_restaurant o steak_house.Il tipo principale potrebbe non essere presente se il tipo principale del luogo non è supportato. Quando è presente un tipo principale, è sempre uno dei tipi nel campo types.
  • Un luogo può avere più valori di tipo dal tipo Tabella A o dal tipo Tabella B associati. Ad esempio, un ristorante potrebbe avere i seguenti tipi: seafood_restaurant, restaurant, food, point_of_interest, establishment.
  • L'indirizzo e i componenti dell'indirizzo di un luogo possono essere taggati con determinati tipi dalla tabella Tipi di indirizzo e tipi di componenti dell'indirizzo. Ad esempio, un indirizzo potrebbe essere taggato come street_address e un componente dell'indirizzo potrebbe essere taggato come street_number.

Puoi anche specificare i tipi di luoghi nell'ambito di una richiesta. Se specificato nella richiesta, il tipo funge da filtro per limitare la risposta in modo da includere solo i luoghi che corrispondono ai tipi specificati.

Informazioni sulle tabelle dei tipi

La tabella A elenca i valori supportati per i tipi di luogo:

  • Nell'ambito di una risposta di Place Details (New), Nearby Search (New) e Text Search (New). I valori della tabella A vengono quindi utilizzati per compilare questi campi.
  • Nell'ambito di una richiesta di ricerca nelle vicinanze (nuova), utilizzato come valore dei parametri includedTypes, excludedTypes, includedPrimaryTypes e excludedPrimaryTypes. I valori della tabella B vengono quindi utilizzati per compilare questi campi.
  • Nell'ambito di una richiesta di ricerca di testo (nuova), utilizzato come valore del parametro includedType.
  • Nell'ambito di una richiesta del widget Place Autocomplete (New), utilizza come valori per il parametro includedPrimaryTypes.
  • Nell'ambito di una risposta del widget Place Autocomplete (nuovo).

La tabella B elenca valori aggiuntivi del tipo di luogo che possono essere restituiti anche nell'ambito di una risposta di Place Details (New), Nearby Search (New), Text Search (New) e Place Autocomplete Widget (New). La richiesta deve specificare almeno uno dei campi places.types o places.primaryType nella maschera del campo. I valori della tabella B NON possono essere utilizzati come parte di una richiesta, ad eccezione dei valori del parametro includedPrimaryTypes per una richiesta del widget Place Autocomplete (New).

L'elenco Tipi di indirizzo e tipi di componenti di indirizzo mostra i tipi che possono essere visualizzati in uno o in entrambi gli array di tipi di indirizzo e tipi di componenti di indirizzo nel corpo della risposta. I tipi di componenti dell'indirizzo sono soggetti a modifica.

Tabella A

Auto e motori
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 *
Crescita
business_center *
corporate_office
coworking_space *
farm
manufacturer *
ranch
supplier *
television_studio *
Cultura
art_gallery
art_museum *
art_studio
auditorium
castle *
cultural_landmark
fountain *
historical_place
history_museum *
monument
museum
performing_arts_theater
sculpture
Istruzione
academic_department *
educational_institution *
library
preschool
primary_school
research_institute *
school
secondary_school
university
Intrattenimento e tempo libero
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
winery *
zoo
Strutture
public_bath
public_bathroom
stable
Finanza
accounting
atm
bank
Cibi e bevande
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 *
Aree geografiche
administrative_area_level_1
administrative_area_level_2
country
locality
postal_code
school_district
Pubblica amministrazione
city_hall
courthouse
embassy
fire_station
government_office
local_government_office
neighborhood_police_station (solo Giappone)
police
post_office
Salute e benessere
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
Edilizia abitativa
apartment_building
apartment_complex
condominium_complex
housing_complex
Alloggi
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
Elementi geografici naturali
beach
island *
lake *
mountain_peak *
nature_preserve *
river *
scenic_spot *
woods *
Luoghi di culto
buddhist_temple *
church
hindu_temple
mosque
shinto_shrine *
synagogue
Servizi
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
Shopping
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 *
Trasporti
airport
yakitori_restaurant *
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

Tabella B

I valori del tipo di luogo nella tabella B possono essere restituiti nell'ambito di una risposta Places Details (New), Nearby Search (New), Text Search (New) o Autocomplete (New). Questi tipi sono supportati anche da includedPrimaryTypes per le richieste di completamento automatico (nuovo).

Valori aggiuntivi per il tipo di luogo
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

Tipi di indirizzo e tipi di componenti dell'indirizzo

L'array types nella risposta indica il tipo di indirizzo. Esempi di tipi di indirizzo includono un indirizzo stradale, un paese o un'entità politica. L'array types nella classe google.maps.places.AddressComponent indica il tipo di ogni parte dell'indirizzo. Alcuni esempi sono il numero civico o il paese.

Gli indirizzi possono avere più tipi. I tipi possono essere considerati "tag". Ad esempio, molte città sono taggate con i tipi political e locality.

I seguenti tipi sono supportati e restituiti sia negli array tipo di indirizzo che tipo di componente di indirizzo:

Tipo di indirizzo Descrizione
street_address Un indirizzo preciso.
route Un percorso denominato (ad esempio "US 101").
intersection Un incrocio principale, di solito tra due strade principali.
political Un'entità politica. In genere, questo tipo indica un poligono di un'amministrazione civile.
country L'entità politica nazionale, in genere il tipo di ordine più elevato restituito dal geocodificatore.
administrative_area_level_1 Una divisione amministrativa principale al di sotto del livello paese. Negli Stati Uniti, questi livelli amministrativi sono gli stati. Non tutte le nazioni presentano questi livelli amministrativi. Nella maggior parte dei casi, i nomi brevi administrative_area_level_1 corrispondono strettamente alle suddivisioni ISO 3166-2 e ad altri elenchi ampiamente diffusi; tuttavia, ciò non è garantito, in quanto i nostri risultati di geocodifica si basano su una serie di indicatori e dati sulla posizione.
administrative_area_level_2 Una divisione amministrativa di secondo livello al di sotto del livello paese. Negli Stati Uniti, questi livelli amministrativi sono le contee. Non tutte le nazioni presentano questi livelli amministrativi.
administrative_area_level_3 Una divisione amministrativa di terzo livello al di sotto del livello paese. Questo tipo indica una suddivisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi.
administrative_area_level_4 Una divisione amministrativa di quarto livello al di sotto del livello paese. Questo tipo indica una suddivisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi.
administrative_area_level_5 Una divisione amministrativa di quinto livello al di sotto del livello paese. Questo tipo indica una suddivisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi.
administrative_area_level_6 Una divisione amministrativa di sesto livello al di sotto del livello paese. Questo tipo indica una suddivisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi.
administrative_area_level_7 Una divisione amministrativa di settimo livello al di sotto del livello paese. Questo tipo indica una suddivisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi.
colloquial_area Un nome alternativo comunemente utilizzato per l'entità.
locality Un'entità politica di una città o di un comune costituita in società.
sublocality Una divisione amministrativa principale al di sotto di una località. Per alcune località potrebbe essere visualizzato uno dei tipi aggiuntivi: sublocality_level_1 - sublocality_level_5. Ogni livello di località secondaria è un'entità civile. Numeri più grandi indicano un'area geografica più piccola.
neighborhood Un quartiere con un nome.
premise Una località denominata, solitamente un edificio o un insieme di edifici con un nome comune.
subpremise Un'entità indirizzabile al di sotto del livello dell'edificio, ad esempio un appartamento, un'unità o una suite.
plus_code Un riferimento alla posizione codificato, derivato da latitudine e longitudine. I Plus Code possono essere utilizzati in sostituzione degli indirizzi stradali in luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno un nome). Per ulteriori dettagli, visita la pagina https://plus.codes.
postal_code Un codice postale utilizzato per la spedizione della posta tradizionale di un paese.
natural_feature Un elemento naturale prominente.
airport Un aeroporto.
park Un parco con nome.
point_of_interest Un punto d'interesse denominato. In genere, questi "POI" sono entità locali importanti che non rientrano facilmente in un'altra categoria, ad esempio "Empire State Building" o "Torre Eiffel".

Un elenco vuoto di tipi indica che non esistono tipi noti per il componente dell'indirizzo specifico (ad esempio, Lieu-dit in Francia).

Oltre a quanto sopra, i componenti dell'indirizzo possono includere i tipi elencati di seguito.

Tipo di componente dell'indirizzo Descrizione
floor Il piano di un indirizzo dell'edificio.
establishment In genere un luogo che non è ancora stato classificato.
landmark Un luogo nelle vicinanze utilizzato come riferimento per facilitare la navigazione.
point_of_interest Un punto d'interesse denominato.
parking Un parcheggio o una struttura per parcheggiare l'auto.
post_box Una casella postale specifica.
postal_town Un raggruppamento di aree geografiche, ad esempio locality e sublocality, utilizzato per gli indirizzi postali in alcuni paesi.
room La stanza di un indirizzo dell'edificio.
street_number Il numero civico esatto.
bus_station, train_station e transit_station La posizione di una fermata di autobus, treno o trasporto pubblico.