Les types de lieux sont des catégories qui identifient les caractéristiques d'un lieu. Un lieu peut être associé à un ou plusieurs types de lieu.
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 Place Autocomplete (New) :
- Un lieu peut être associé à un seul type principal du type Table A ou Table B.
Par exemple, le type principal peut être
mexican_restaurant
ousteak_house
. - Un lieu peut avoir plusieurs types du type Tableau A ou du type Tableau B.
Par exemple, un restaurant peut avoir les types suivants :
seafood_restaurant
,restaurant
,food
,point_of_interest
etestablishment
. - 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_address
et 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 agit comme un filtre pour limiter la réponse à n'inclure que les lieux correspondant aux types spécifiés.
À propos des tableaux 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
,includedPrimaryTypes
etexcludedPrimaryTypes
. 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 Widget Place Autocomplete (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
Widget Place Autocomplete (New). La requête doit spécifier au moins 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).
Types d'adresses et de composants d'adresse liste les types pouvant apparaître dans les tableaux de type d'adresse et de type de composant d'adresse, ou dans les deux, dans le corps de la réponse. Les types de composants d'adresse sont susceptibles d'être modifiés.
Tableau A
Automobile | ||
---|---|---|
car_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
Entreprise | ||
corporate_office *farm ranch * |
||
Culture | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Éducation | ||
library preschool primary_school
|
school secondary_school university
|
|
Loisirs et divertissements | ||
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
|
Locaux | ||
public_bath *public_bathroom *stable *
|
||
Finance | ||
accounting atm bank
|
||
Alimentation et boissons | ||
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 *
|
Zones géographiques | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Administration | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (Japon uniquement)police post_office
|
|
Santé et bien-être | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Housing | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Hébergement | ||
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
|
|
Éléments naturels | ||
beach *
|
||
Lieux de culte | ||
church hindu_temple mosque synagogue
|
||
Services | ||
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
|
|
Transports | ||
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
|
Tableau B
Valeurs de type de lieu supplémentaires | ||
---|---|---|
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
|
Types d'adresses et de composants d'adresse
Le tableau types
dans la réponse indique le type d'adresse. Les types d'adresses incluent une adresse, 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 type d'adresse et de type de composant d'adresse:
Type d'adresse | Description |
---|---|
street_address |
Une adresse postale précise. |
route |
Route nommée (par exemple, "US 101"). |
intersection |
Intersection majeure, généralement entre 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 géocodeur. |
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 correspondent 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: 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 au-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 |
Élément géographique 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 |
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 parking couvert |
post_box |
Boîte postale spécifique. |
postal_town |
Regroupement 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. |