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), 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 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 tipi utilizzati nei seguenti modi:

• Nell'ambito di una risposta di Place Details (New), Nearby Search (New) e Text Search (New). La richiesta deve specificare almeno uno dei campi places.types o places.primaryType nella maschera del campo. 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 di completamento automatico (nuovo), utilizza come valori per il parametro includedPrimaryTypes.
• Nell'ambito di una risposta di completamento automatico (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 Autocomplete (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 di completamento automatico (nuovo).

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

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 indirizzi 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 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 taggate con i tipi political e locality.

Sono supportati e restituiti i seguenti tipi negli array di tipi di indirizzo e tipi di componenti 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 nei 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 "PDI" 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.