Les types de lieux sont des catégories qui identifient les caractéristiques d'un lieu. Un lieu peut se voir attribuer un ou plusieurs types de lieux.
Les types d'un lieu sont inclus dans la réponse d'une requête Place Details (New), Nearby Search (New), Text Search (New) et Autocomplete (New) :
- Un lieu peut être associé à un type principal unique du type Tableau A ou Tableau B.
Par exemple, le type principal peut être
mexican_restaurantousteak_house.Le type principal peut être manquant si le type principal du lieu n'est pas un type accepté. Lorsqu'un type principal est présent, il s'agit toujours de l'un des types du champtypes. - Un lieu peut être associé à plusieurs valeurs de type du Tableau A ou du Tableau B.
Par exemple, un restaurant peut avoir les types suivants :
seafood_restaurant,restaurant,food,point_of_interest,establishment. - L'adresse et les composants d'adresse d'un lieu peuvent être tagués avec certains types du tableau Types d'adresses et de composants d'adresse. Par exemple, une adresse peut être taguée comme
street_addresset un composant de l'adresse peut être tagué commestreet_number.
Vous pouvez également spécifier des types de lieux dans une requête. Lorsqu'il est spécifié dans la requête, le type sert de filtre pour limiter la réponse aux lieux qui correspondent aux types spécifiés.
À propos des tables de types
Le Tableau A liste les valeurs acceptées pour les types de lieu :
- Dans une réponse de Place Details (New), Nearby Search (New) et Text Search (New). Les valeurs du Tableau A servent ensuite à remplir ces champs.
- Dans une requête Nearby Search (New), sert de valeur des paramètres
includedTypes,excludedTypes,includedPrimaryTypesetexcludedPrimaryTypes. Les valeurs du Tableau B servent ensuite à remplir ces champs. - Dans une requête Text Search (New), sert de valeur du paramètre
includedType. - Dans une requête Place Autocomplete Widget (New),
sert de valeurs du paramètre
includedPrimaryTypes. - Dans une réponse du widget Place Autocomplete (New).
Le Tableau B liste les valeurs de type de lieu supplémentaires qui peuvent être renvoyées dans une réponse Place Details (New),
Nearby Search (New),
Text Search (New) et
Place Autocomplete Widget (New). La requête doit spécifier au moins l'un des champs places.types ou places.primaryType dans le masque de champ.
Les valeurs du Tableau B ne peuvent PAS être utilisées dans une requête, sauf comme valeurs du paramètre includedPrimaryTypes pour une requête Place Autocomplete Widget (New).
Les types d'adresses et de composants d'adresse listent les types qui peuvent apparaître dans les tableaux de types d'adresses et de composants d'adresse dans le corps de la réponse. Les types de composants d'adresse sont susceptibles d'être modifiés.
Tableau A
| Automobile | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| Entreprise | ||
corporate_office *farmranch * |
||
| Culture | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| Éducation | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| Loisirs et divertissements | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue |
ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo
|
| Locaux | ||
public_bath *public_bathroom *stable *
|
||
| Finance | ||
accountingatmbank
|
||
| Alimentation et boissons | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant |
mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar *
|
| Zones géographiques | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Administration | ||
city_hallcourthouseembassyfire_stationgovernment_office *
|
local_government_officeneighborhood_police_station (Japon uniquement)policepost_office
|
|
| Santé et bien-être | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| Housing | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| Hébergement | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| Éléments naturels | ||
beach *
|
||
| Lieux de culte | ||
churchhindu_templemosquesynagogue
|
||
| Services | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * |
lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care
|
|
| Shopping | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store
|
home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler
|
|
| Sport | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * |
playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool
|
|
| Transports | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station |
park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_stop
|
|
Tableau B
Les valeurs de type de lieu du Tableau B peuvent être renvoyées dans une réponse Place Details (New),
Nearby Search (New),
Text Search (New) ou
Autocomplete (New). Ces types sont également acceptés par includedPrimaryTypes pour les requêtes Autocomplete (nouveau).
| Valeurs de type de lieu supplémentaires | ||
|---|---|---|
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
|
|
Types d'adresses et de composants d'adresse
Le tableau types de la réponse indique le type d'adresse. Les types d'adresses incluent une adresse postale, un pays ou une entité politique. Le tableau types de la classe google.maps.places.AddressComponent indique le type de chaque partie de l'adresse. (un numéro de rue ou un pays, par exemple).
Les adresses peuvent avoir plusieurs types. Les types peuvent être considérés comme des "tags".
Par exemple, de nombreuses villes sont taguées avec les types political et locality.
Les types suivants sont acceptés et renvoyés dans les tableaux de types d'adresse et de composant d'adresse :
| Type d'adresse | Description |
|---|---|
street_address |
Adresse postale précise. |
route |
Route nommée (par exemple, "US 101"). |
intersection |
Intersection majeure, généralement sur deux routes principales. |
political |
Entité politique. Habituellement, ce type indique un polygone de certaines administrations civiles. |
country |
Entité politique nationale, généralement le type de premier ordre renvoyé par le Geocoder. |
administrative_area_level_1 |
Entité civile de premier ordre en dessous du niveau du pays. Aux États-Unis, ces niveaux administratifs correspondent aux États. Toutes les nations ne possèdent pas ces niveaux administratifs. Dans la plupart des cas, les noms courts administrative_area_level_1 correspondront fidèlement aux subdivisions ISO 3166-2 et aux autres listes largement diffusées. Cependant, cela n'est pas systématique, car nos résultats de géocodage se basent sur divers signaux et données de localisation. |
administrative_area_level_2 |
Entité civile de deuxième ordre en dessous du niveau du pays. Aux États-Unis, ces niveaux administratifs correspondent aux comtés. Toutes les nations ne possèdent pas ces niveaux administratifs. |
administrative_area_level_3 |
Entité civile de troisième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. |
administrative_area_level_4 |
Entité civile de quatrième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. |
administrative_area_level_5 |
Entité civile de cinquième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. |
administrative_area_level_6 |
Entité civile de sixième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. |
administrative_area_level_7 |
Entité civile de septième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. |
colloquial_area |
Autre nom couramment utilisé pour l'entité. |
locality |
Entité politique de ville ou de municipalité incorporée. |
sublocality |
Entité civile de premier ordre située en dessous d'une localité. Pour certains établissements, vous pouvez recevoir l'un des types supplémentaires suivants : de sublocality_level_1 à sublocality_level_5. Chaque niveau de sous-localité correspond à une entité civile. Plus le nombre est élevé, plus la zone géographique est petite. |
neighborhood |
Quartier nommé. |
premise |
Lieu nommé, généralement un bâtiment ou un ensemble de bâtiments ayant un nom commun. |
subpremise |
Entité adressable en dessous du niveau de l'établissement, comme un appartement, un logement ou une suite. |
plus_code |
Référence de lieu encodée, déterminée par la latitude et la longitude. Vous pouvez utiliser des Plus Codes pour remplacer les adresses postales dans les endroits où elles n'existent pas (où les bâtiments ne sont pas numérotés ni nommés). Pour en savoir plus, consultez https://plus.codes. |
postal_code |
Code postal, utilisé pour adresser le courrier postal dans le pays. |
natural_feature |
Un élément naturel important. |
airport |
Un aéroport. |
park |
Parc nommé. |
point_of_interest |
Point d'intérêt nommé. En général, ces "POI" sont des entités locales importantes qui ne correspondent à aucune autre catégorie, comme "Empire State Building" ou "Tour Eiffel". |
Une liste de types vide indique qu'il n'y a aucun type connu pour un composant d'adresse particulier (par exemple, un Lieu-dit en France).
En plus des types énumérés ci-dessus, les composants d'adresse peuvent contenir les types suivants.
| Type de composant d'adresse | Description |
|---|---|
floor |
Étage d'une adresse d'immeuble. |
establishment |
Il s'agit généralement d'un lieu qui n'a pas encore été classé. |
landmark |
Un lieu à proximité qui sert de référence pour faciliter la navigation. |
point_of_interest |
Point d'intérêt nommé. |
parking |
Un parking ou un espace de stationnement. |
post_box |
Une boîte postale spécifique. |
postal_town |
Groupe de zones géographiques, comme locality et sublocality, utilisé pour les adresses postales dans certains pays. |
room |
Salle associée à l'adresse d'un bâtiment. |
street_number |
Numéro de rue précis. |
bus_station, train_station et transit_station |
Emplacement d'un arrêt de bus, de train ou de transports en commun. |