Tipi di luoghi

Seleziona la piattaforma: Android iOS JavaScript Web Service

I tipi di luoghi 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 (nuova), Nearby Search (nuova), Text Search (nuova) e Place Autocomplete (nuova):

  • A un luogo può essere associato un unico tipo principale del tipo Tabella A o del tipo Tabella B. Ad esempio, il tipo principale potrebbe essere mexican_restaurant o steak_house.
  • A un luogo possono essere associati più valori di tipo del tipo Tabella A o del tipo Tabella B. 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 indirizzi e tipi di componenti dell'indirizzo. Ad esempio, un indirizzo potrebbe essere contrassegnato come street_address e un componente dell'indirizzo potrebbe essere contrassegnato come street_number.

Puoi anche specificare i tipi di luoghi all'interno di una richiesta. Se specificato nella richiesta, il tipo funge da filtro per limitare la risposta a includere solo i luoghi corrispondenti ai tipi specificati.

Informazioni sulle tabelle di tipo

La Tabella A elenca i valori supportati per i tipi di luoghi:

  • Nell'ambito di una risposta di Dettagli dei luoghi (novità), Cerca nelle vicinanze (novità) e Ricerca di testo (novità). I valori della tabella A vengono poi utilizzati per compilare questi campi.
  • Nell'ambito di una richiesta di ricerca nelle vicinanze (nuova), viene utilizzato come valore del parametro includedTypes, excludedTypes, includedPrimaryTypes e excludedPrimaryTypes. I valori della tabella B vengono poi utilizzati per compilare questi campi.
  • Nell'ambito di una richiesta di ricerca di testo (nuova), viene utilizzato come valore del parametro includedType.
  • Nell'ambito di una richiesta di widget Place Autocomplete (nuovo), utilizzali come valori per il parametro includedPrimaryTypes.
  • Nell'ambito di una risposta del widget Place Autocomplete (nuovo).

La tabella B elenca ulteriori valori di tipo di luogo che possono essere restituiti anche nell'ambito di una risposta di Dettagli dei luoghi (novità), Ricerca nelle vicinanze (novità), Ricerca di testo (novità) e Widget di completamento automatico dei luoghi (novità). La richiesta deve specificare almeno uno dei campi places.types o places.primaryType nella maschera di campi. I valori della Tabella B NON possono essere utilizzati all'interno di una richiesta, tranne che come valori del parametro includedPrimaryTypes per una richiesta del widget di completamento automatico dei luoghi (nuovo).

Tipi di indirizzi e tipi di componenti dell'indirizzo elenca i tipi che possono apparire in uno o entrambi gli array di tipo di indirizzo e tipo di componente dell'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
 electric_vehicle_charging_station
gas_station
parking
rest_stop
Attività commerciale
corporate_office *
farm
ranch *
Cultura
art_gallery
art_studio *
auditorium *
cultural_landmark *
historical_place *
 monument *
museum
performing_arts_theater
sculpture *
Istruzione
library
preschool
primary_school 		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 *
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
Strutture
public_bath *
public_bathroom *
stable *
Finanza
accounting
atm
bank
Cibi e bevande
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 *
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 in Giappone)
police
post_office
Salute e benessere
chiropractor *
dental_clinic
dentist
doctor
drugstore
hospital
massage *
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 *
Luoghi di culto
church
hindu_temple
mosque
synagogue
Servizi
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
Shopping
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
Trasporti
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

Tabella B

Altri valori 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 indirizzi e tipi di componenti di indirizzi

L'array types nella risposta indica il tipo di indirizzo. Esempi di tipi di indirizzi includono un indirizzo, 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 contrassegnate con i tipi political e locality.

I seguenti tipi sono supportati e restituiti sia nell'array di tipo indirizzo sia nell'array di tipo di componente indirizzo:

Tipo di indirizzo Descrizione
street_address Un indirizzo stradale preciso.
route Un percorso denominato (ad esempio "US 101").
intersection Un incrocio importante, in genere di due strade principali.
political Un'entità politica. In genere, questo tipo indica un poligono di un'amministrazione civile.
country L'entità politica nazionale ed è in genere il tipo di ordine più elevato restituito dal geocodificatore.
administrative_area_level_1 Un'entità civile di primo livello al di sotto del livello del paese. Negli Stati Uniti, questi livelli amministrativi sono gli stati. Non tutti i paesi presentano questi livelli amministrativi. Nella maggior parte dei casi, i nomi brevi administrative_area_level_1 corrispondono quasi esattamente alle suddivisioni ISO 3166-2 e ad altri elenchi ampiamente diffusi; tuttavia, non è garantito, in quanto i nostri risultati di geocodifica si basano su una serie di indicatori e dati sulla posizione.
administrative_area_level_2 Un'entità civile di secondo ordine al di sotto del livello del paese. Negli Stati Uniti, questi livelli amministrativi sono le contee. Non tutti i paesi presentano questi livelli amministrativi.
administrative_area_level_3 Un'entità civile di terzo ordine al di sotto del livello del paese. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
administrative_area_level_4 Una persona giuridica civile di quarto ordine al di sotto del livello del paese. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
administrative_area_level_5 Un'entità civile di quinto ordine al di sotto del livello del paese. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
administrative_area_level_6 Un'entità civile di sesto ordine al di sotto del livello del paese. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
administrative_area_level_7 Un'entità civile di settimo ordine al di sotto del livello del paese. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
colloquial_area Un nome alternativo di uso comune per l'entità.
locality Un'entità politica costituita come città o paese.
sublocality Un'entità civile di primo livello sotto una località. Per alcune località potrebbe essere visualizzato uno dei tipi aggiuntivi da sublocality_level_1 a sublocality_level_5. Ogni livello di località secondaria è un'entità civile. Numeri più grandi indicano un'area geografica più piccola.
neighborhood Un quartiere denominato.
premise Una località con nome, in genere un edificio o una serie di edifici con un nome comune.
subpremise Un'entità indirizzabile al di sotto del livello della proprietà, 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 al posto degli indirizzi civici nei luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno nome). Per ulteriori dettagli, visita la pagina https://plus.codes.
postal_code Un codice postale utilizzato per la spedizione della posta tradizionale all'interno del paese.
natural_feature Un elemento naturale in evidenza.
airport Un aeroporto.
park Un parco con nome.
point_of_interest Un punto d'interesse denominato. In genere, questi "PDI" sono entità locali importanti che non rientrano facilmente in un'altra categoria, come "Empire State Building" o "Torre Eiffel".

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

Oltre a quanto indicato 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 è stato ancora 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 un'area di parcheggio.
post_box Una cassetta 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.