Places UI Kit: una libreria pronta all'uso che offre spazio per la personalizzazione e il controllo agli sviluppatori. Provalo e condividi il tuo feedback sull'esperienza con UI Kit.

Questa pagina è stata tradotta dall'API Cloud Translation.

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 è un tipo 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 della 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 del parametro 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 (New).

La tabella B elenca valori aggiuntivi del tipo di luogo che possono essere restituiti anche nell'ambito di una risposta Places 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 (nuovo).

L'elenco Tipi di indirizzo e tipi di componenti di indirizzo mostra i tipi che possono essere visualizzati in uno o 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
Soluzioni aziendali
Cultura
Istruzione
Intrattenimento e svago
Strutture *
Finanza
Cibi e bevande
Aree geografiche
Pubblica amministrazione

Salute e benessere
Alloggi *
Alloggio
Elementi naturali *
Luoghi di culto
Servizi
Shopping
Sport
Trasporti

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 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

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 di tipi di indirizzo sia in quelli di componenti di indirizzo:

Tipo di indirizzo	Descrizione
`street_address`	Un indirizzo preciso.
`route`	Un percorso denominato (ad esempio "US 101").
`intersection`	Un incrocio importante, 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 nazionale. 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 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`	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 nazionale. Questo tipo indica una suddivisione civile minore. Non tutti i paesi presentano questi livelli amministrativi.
`administrative_area_level_4`	Un'entità civile di quarto ordine al di sotto del livello nazionale. 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 nazionale. 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 nazionale. Questo tipo indica una suddivisione civile minore. Non tutti i paesi 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 sotto 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 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 con nome. 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 particolare componente dell'indirizzo (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 con nome.
`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.