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 (New), Nearby Search (New), Ricerca testuale (New) e Autocomplete (New):
- Un luogo può avere un unico tipo principale del tipo
Tabella A o del tipo Tabella B associato.
Ad esempio, il tipo principale potrebbe essere
mexican_restaurantosteak_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 campotypes. - 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 degli indirizzi. Ad esempio, un
indirizzo potrebbe essere taggato come
street_addresse un componente dell'indirizzo potrebbe essere taggato comestreet_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
Ricerca testuale (New), i
valori nella Tabella A vengono utilizzati per compilare la proprietà types dell'istanza
Place. La richiesta deve specificarePlace.Field.TYPESoPlace.Field.PRIMARY_TYPEnell'elenco dei campi. - Nell'ambito di una richiesta di Nearby Search (New), utilizzato come valore dei parametri dei tipi inclusi, dei tipi esclusi, dei tipi principali inclusi e dei tipi principali esclusi.
- Nell'ambito di una richiesta di Ricerca testuale (nuova), utilizzato come valore del parametro di tipo incluso.
- Nell'ambito di una richiesta di completamento automatico di Place Autocomplete (nuovo), utilizza come valori per il parametro dei tipi principali.
- Come parte di una risposta di Place Autocomplete (New) utilizzata per compilare la proprietà types dell'istanza
AutocompletePrediction.
La tabella B elenca valori aggiuntivi del tipo di luogo
che possono essere restituiti anche come parte di una
risposta di Place Details (nuovo),
Nearby Search (nuova),
Ricerca testuale (nuova) e
Place Autocomplete (nuovo). La richiesta deve
specificare Place.Field.TYPES o Place.Field.PRIMARY_TYPE
nell'elenco dei campi. I valori della Tabella B NON devono essere utilizzati come parte di una richiesta, ad eccezione dei valori per il parametro dei tipi principali per una richiesta di Place Autocomplete (nuova).
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 | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| Crescita | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| Cultura | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| Istruzione | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| Intrattenimento e tempo libero | ||
adventure_sports_centeramphitheatreamusement_centeramusement_parkaquariumbanquet_hallbarbecue_areabotanical_gardenbowling_alleycasinochildrens_campcity_park *comedy_clubcommunity_centerconcert_hallconvention_centercultural_centercycling_parkdance_halldog_parkevent_venueferris_wheelgardengo_karting_venue * |
hiking_areahistorical_landmarkindoor_playground *internet_cafekaraokelive_music_venue *marinaminiature_golf_course *movie_rentalmovie_theaternational_parknight_clubobservation_deckoff_roading_areaopera_housepaintball_center *parkphilharmonic_hallpicnic_groundplanetariumplazaroller_coasterskateboard_parkstate_park |
tourist_attractionvideo_arcadevineyard *visitor_centerwater_parkwedding_venuewildlife_parkwildlife_refugezoo
|
| Strutture | ||
public_bathpublic_bathroomstable
|
||
| Finanza | ||
accountingatmbank
|
||
| Cibi e bevande | ||
acai_shopafghani_restaurantafrican_restaurantamerican_restaurantargentinian_restaurant *asian_fusion_restaurant *asian_restaurantaustralian_restaurant *austrian_restaurant *bagel_shopbakerybangladeshi_restaurant *barbar_and_grillbarbecue_restaurantbasque_restaurant *bavarian_restaurant *beer_garden *belgian_restaurant *bistro *brazilian_restaurantbreakfast_restaurantbrewery *brewpub *british_restaurant *brunch_restaurantbuffet_restaurantburmese_restaurant *burrito_restaurant *cafecafeteriacajun_restaurant *cake_shop *californian_restaurant *cambodian_restaurant *candy_storecantonese_restaurant *caribbean_restaurant *cat_cafechicken_restaurant *chicken_wings_restaurant *chilean_restaurant *chinese_noodle_restaurant *chinese_restaurantchocolate_factorychocolate_shopcocktail_bar *coffee_roastery *coffee_shopcoffee_stand *colombian_restaurant *confectionerycroatian_restaurant *cuban_restaurant *czech_restaurant *danish_restaurant *deli |
dessert_restaurantdessert_shopdim_sum_restaurant *dinerdog_cafedonut_shopdumpling_restaurant *dutch_restaurant *eastern_european_restaurant *ethiopian_restaurant *european_restaurant *falafel_restaurant *family_restaurant *fast_food_restaurantfilipino_restaurant *fine_dining_restaurantfish_and_chips_restaurant *fondue_restaurant *food_courtfrench_restaurantfusion_restaurant *gastropub *german_restaurant *greek_restaurantgyro_restaurant *halal_restaurant* hamburger_restauranthawaiian_restaurant *hookah_bar *hot_dog_restaurant *hot_dog_stand *hot_pot_restaurant *hungarian_restaurant *ice_cream_shopindian_restaurantindonesian_restaurantirish_pub *irish_restaurant *israeli_restaurant *italian_restaurantjapanese_curry_restaurant *japanese_izakaya_restaurant *japanese_restaurantjuice_shopkebab_shop *korean_barbecue_restaurant *korean_restaurantlatin_american_restaurant *lebanese_restaurantlounge_bar *malaysian_restaurant *meal_deliverymeal_takeawaymediterranean_restaurantmexican_restaurantmiddle_eastern_restaurantmongolian_barbecue_restaurant * |
moroccan_restaurant *noodle_shop *north_indian_restaurant *oyster_bar_restaurant *pakistani_restaurant *pastry_shop *persian_restaurant *peruvian_restaurant *pizza_delivery *pizza_restaurantpolish_restaurant *portuguese_restaurant *pubramen_restaurantrestaurantromanian_restaurant *russian_restaurant *salad_shop *sandwich_shopscandinavian_restaurant *seafood_restaurantshawarma_restaurant *snack_bar *soul_food_restaurant *soup_restaurant *south_american_restaurant *south_indian_restaurant *southwestern_us_restaurant *spanish_restaurantsports_bar *sri_lankan_restaurant *steak_housesushi_restaurantswiss_restaurant *taco_restaurant *taiwanese_restaurant *tapas_restaurant *tea_housetex_mex_restaurant *thai_restauranttibetan_restaurant *tonkatsu_restaurant *turkish_restaurantukrainian_restaurant *vegan_restaurantvegetarian_restaurantvietnamese_restaurantwestern_restaurant *wine_barwinery *yakiniku_restaurant *yakitori_restaurant * |
| Aree geografiche | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Pubblica amministrazione | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station (solo Giappone)policepost_office
|
|
| Salute e benessere | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| Edilizia abitativa | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| Alloggi | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| Elementi geografici naturali | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| Luoghi di culto | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| Servizi | ||
aircraft_rental_service *association_or_organization *astrologerbarber_shopbeauticianbeauty_salonbody_art_servicecatering_servicecemeterychauffeur_service *child_care_agencyconsultantcourier_serviceelectricianemployment_agency *floristfood_deliveryfoot_carefuneral_homehair_carehair_saloninsurance_agencylaundrylawyerlocksmith |
makeup_artistmarketing_consultant *moving_companynail_salonnon_profit_organization *painterpet_boarding_service *pet_care *plumberpsychicreal_estate_agencyroofing_contractorservice *shipping_service *storagesummer_camp_organizertailortelecommunications_service_providertour_agencytourist_information_centertravel_agencyveterinary_care
|
|
| Shopping | ||
asian_grocery_storeauto_parts_storebicycle_storebook_storebuilding_materials_store *butcher_shopcell_phone_storeclothing_storeconvenience_storecosmetics_store *department_storediscount_storediscount_supermarket *electronics_storefarmers_market *flea_market *food_storefurniture_storegarden_center *general_store *gift_shopgrocery_storehardware_storehealth_food_store *home_goods_store
|
home_improvement_storehypermarket *jewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storesportswear_store *storesupermarkettea_store *thrift_store *toy_store *warehouse_storewholesalerwomens_clothing_store * |
|
| Sport | ||
arenaathletic_fieldfishing_charterfishing_pier *fishing_pondfitness_centergolf_coursegymice_skating_rinkindoor_golf_course * |
playgroundrace_course *ski_resortsports_activity_locationsports_clubsports_coachingsports_complexsports_school *stadiumswimming_pool *tennis_court * |
|
| Trasporti | ||
airportairstripbike_sharing_station *bridge *bus_stationbus_stopferry_service *ferry_terminalheliportinternational_airportlight_rail_stationpark_and_ride |
subway_stationtaxi_service *taxi_standtoll_station *train_stationtrain_ticket_office *tram_stop *transit_depottransit_stationtransit_stop *transportation_service *truck_stop
|
|
Tabella B
I valori dei tipi di luoghi nella Tabella B possono essere restituiti come parte di una risposta di Place Details (New), Nearby Search (New), Ricerca testuale (New) o Autocomplete (New). Questi tipi sono supportati anche
da includedPrimaryTypes per le richieste di completamento automatico (nuovo).
| Valori aggiuntivi del tipo di luogo | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code
|
point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_square
|
|
Tipi di indirizzi e tipi di componenti degli indirizzi
L'enum getPlaceTypes nella risposta indica il tipo di indirizzo. Esempi di tipi di indirizzo includono un indirizzo, un paese o un'entità politica. L'array types nella
classe 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 negli array dei tipi di indirizzo e 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 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 utilizzano 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 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 un comune incorporato. |
sublocality |
Una divisione amministrativa principale al di sotto di 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. I numeri più grandi indicano un'area geografica più piccola. |
neighborhood |
Un quartiere con un nome. |
premise |
Una località denominata, 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 delle vie 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 di un 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 "POI" 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 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 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 denominato. |
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 dell'autobus, del treno o del trasporto pubblico. |