Tipi di luogo (nuovi)

Introduzione

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), Ricerca testuale (New) e Autocomplete (New):

• A un luogo può essere associato un singolo tipo principale della Tabella A o della Tabella B. 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.
• A un luogo possono essere associati più valori di tipo della Tabella A o della 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 contrassegnati con determinati tipi della tabella Tipi di indirizzi 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 tipi utilizzati nei seguenti modi:

• Come parte di una risposta di Place Details (New), Nearby Search (New) e Ricerca testuale (New). La richiesta deve specificare almeno uno dei campi places.types o places.primaryType nella maschera di campo. I valori della Tabella A vengono quindi utilizzati per compilare questi campi.
• Nell'ambito di una richiesta di Nearby Search (New), utilizzato come valore dei parametri includedTypes, excludedTypes, includedPrimaryTypes e excludedPrimaryTypes. I valori della Tabella B vengono quindi utilizzati per compilare questi campi.
• Come parte di una richiesta di Ricerca testuale (nuova), utilizzato come valore del parametro includedType.
• Nell'ambito di una richiesta di Autocomplete (New), utilizza come valori per il parametro includedPrimaryTypes.
• Come parte di una risposta di Autocomplete (New).

La Tabella B elenca altri valori dei tipi di luogo che possono essere restituiti anche come parte di una risposta di Place Details (New), Nearby Search (New), Ricerca testuale (New) e Autocomplete (New). La richiesta deve specificare almeno uno dei campi places.types o places.primaryType nella maschera di 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 Autocomplete (New).

La Tabella C elenca le raccolte di tipi che possono essere utilizzate come valore del parametro includedPrimaryTypes in una richiesta di Autocomplete (New). Le raccolte di tipi non possono essere specificate con altri valori di tipo.

Tipi di indirizzi e tipi di componenti degli indirizzi elenca i tipi che possono essere visualizzati negli array di tipi di indirizzi e/o di componenti degli indirizzi nel corpo della risposta. I tipi di componenti dell'indirizzo sono soggetti a modifiche.

Tabella A

thought

Auto e motori Soluzioni aziendali Cultura Istruzione Intrattenimento e svago Servizi Finanza Cibi e bevande Aree geografiche Pubblica amministrazione

Salute e benessere Settore immobiliare Alloggio Elementi naturali Luoghi di culto Servizi Shopping Sport Trasporti

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 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 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 dei tipi di luogo nella Tabella B possono essere restituiti nell'ambito di una risposta di Place Details (New), Nearby Search (New), Ricerca testuale (New) o Completamento automatico (New). Questi tipi sono supportati anche da includedPrimaryTypes per le richieste di Autocomplete (New).

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

Tabella C

Le raccolte di tipi possono essere utilizzate come valore includedPrimaryTypes nelle richieste di Autocomplete (New). L'utilizzo di una raccolta di tipi restituisce tutti i risultati che corrispondono a uno dei tipi inclusi associati. Le raccolte di tipi non possono essere specificate con altri valori di tipo.

Raccolta di caratteri tipografici	Tipi inclusi
(regions)	Filtri per aree o divisioni, ad esempio quartieri e codici postali.
(cities)	Filtra i luoghi che Google identifica come città.

Tipi di indirizzi e tipi di componenti degli indirizzi

L'array types nella risposta indica il tipo di indirizzo. Esempi di tipi di indirizzo includono un indirizzo, un paese o un'entità politica. L'array types nel campo 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 negli array dei tipi di indirizzo sia in quelli dei tipi di componenti dell'indirizzo:

Tipo di indirizzo	Descrizione
street_address	Un indirizzo preciso.
route	Un percorso con nome (ad es. "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 paese. Negli Stati Uniti, questi livelli amministrativi sono gli stati. Non tutte le nazioni utilizzano questi livelli amministrativi. Nella maggior parte dei casi, i nomi brevi administrative_area_level_1 corrispondono esattamente alle suddivisioni ISO 3166-2 e ad altri elenchi ampiamente diffusi. Tuttavia, questo non è garantito, poiché 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 utilizzano questi livelli amministrativi.
administrative_area_level_3	Una divisione amministrativa di terzo livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi.
administrative_area_level_4	Una divisione amministrativa di quarto livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi.
administrative_area_level_5	Una divisione amministrativa di quinto livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi.
administrative_area_level_6	Una divisione amministrativa di sesto livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi.
administrative_area_level_7	Una divisione amministrativa di settimo livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi.
colloquial_area	Un nome alternativo di uso comune per l'entità.
locality	Un'entità politica di una città o di un comune incorporato.
sublocality	Una divisione amministrativa principale al di sotto di una località. Per alcune località, potresti ricevere uno dei tipi aggiuntivi: da sublocality_level_1 a sublocality_level_5. Ogni livello di località secondaria è un'entità civile. I numeri più grandi indicano un'area geografica più piccola.
neighborhood	Un quartiere con un nome.
premise	Una località con un nome, di solito 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 di località codificato, derivato da latitudine e longitudine. I Plus Code possono essere utilizzati in sostituzione degli indirizzi nei luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno un nome). Per maggiori dettagli, visita la pagina https://plus.codes.
postal_code	Un codice postale utilizzato per la spedizione della posta tradizionale nel paese.
natural_feature	Un elemento naturale di rilievo.
airport	Un aeroporto.
park	Un parco con un nome.
point_of_interest	Un punto d'interesse con un nome. In genere, questi "PDI" sono entità locali di rilievo che non rientrano facilmente in un'altra categoria, come "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 di un 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 con un nome.
parking	Un parcheggio o una struttura per parcheggiare l'auto.
post_box	Una casella postale specifica.
postal_town	Un raggruppamento di aree geografiche, come locality e sublocality, utilizzato per gli indirizzi postali in alcuni paesi.
room	La stanza di un indirizzo di un edificio.
street_number	Il numero civico preciso.
bus_station, train_station e transit_station	La posizione di una fermata di autobus, treno o trasporto pubblico.