Tipos de lugares (novo)

Selecione a plataforma: Android iOS JavaScript Web Service

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

Os tipos de lugar são categorias que identificam as características de um lugar. Um lugar pode ter um ou mais tipos atribuídos a ele.

Os tipos de um lugar são incluídos na resposta de uma solicitação de Place Details (novo), Nearby Search (novo), Text Search (novo) e Autocomplete (novo):

Um lugar pode ter um único tipo principal do tipo Tabela A ou Tabela B associado a ele. Por exemplo, o tipo principal pode ser mexican_restaurant ou steak_house.O tipo principal pode estar ausente se o tipo principal do lugar não for compatível. Quando um tipo principal está presente, ele é sempre um dos tipos no campo types.
Um lugar pode ter vários valores de tipo da Tabela A ou da Tabela B associados a ele. Por exemplo, um restaurante pode ter os seguintes tipos: seafood_restaurant, restaurant, food, point_of_interest, establishment.
O endereço e os componentes de endereço de um lugar podem ser marcados com determinados tipos da tabela Tipos de endereço e de componentes de endereço. Por exemplo, um endereço pode ser marcado como um street_address, e um componente dele pode ser marcado como um street_number.

Também é possível especificar tipos de lugares como parte de uma solicitação. Quando especificado na solicitação, o tipo atua como um filtro para restringir a resposta e incluir apenas lugares que correspondem aos tipos especificados.

Sobre as tabelas de tipos

A Tabela A lista os tipos usados das seguintes maneiras:

Como parte de uma resposta de Place Details (novo), Nearby Search (novo) e Text Search (novo). A solicitação precisa especificar pelo menos um dos campos places.types ou places.primaryType na máscara de campo. Em seguida, os valores na Tabela A são usados para preencher esses campos.
Como parte de uma solicitação de Nearby Search (novo), usada como os valores dos parâmetros includedTypes, excludedTypes, includedPrimaryTypes e excludedPrimaryTypes. Em seguida, os valores da Tabela B são usados para preencher esses campos.
Como parte de uma solicitação de Text Search (novo), usada como o valor do parâmetro includedType.
Como parte de uma solicitação de Autocomplete (novo), usada como os valores do parâmetro includedPrimaryTypes.
Como parte de uma resposta do Autocomplete (novo).

A Tabela B lista outros valores de tipo de lugar que também podem ser retornados como parte de uma resposta de Place Details (novo), Nearby Search (novo), Text Search (novo) e Autocomplete (novo). A solicitação precisa especificar pelo menos um dos campos places.types ou places.primaryType na máscara de campo. Os valores da Tabela B NÃO podem ser usados como parte de uma solicitação, exceto como os valores do parâmetro includedPrimaryTypes para uma solicitação de Autocomplete (novo).

Tipos de endereço e de componentes de endereço listam os tipos que podem aparecer em um ou nos dois tipos de endereço e matrizes de tipo de componente de endereço no corpo da resposta. Os tipos de componentes de endereço estão sujeitos a mudanças.

Tabela A

Automotive
Negócios
Cultura
Educação
Lazer e recreação
Instalações
Finanças
Alimentos e bebidas
Áreas geográficas
Governo

Saúde e bem-estar
Moradia
Hospedagem
Recursos naturais
Locais de culto
Serviços
Compras
Esportes
Transporte

Automóveis
`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` *
Negócios
`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`
Educação
`academic_department` * `educational_institution` * `library` `preschool` `primary_school`	`research_institute` * `school` `secondary_school` `university`
Lazer e recreação
`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` `winery` * `zoo`
Instalações
`public_bath` `public_bathroom` `stable`
Finanças
`accounting` `atm` `bank`
Alimentos e bebidas
`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` *
Áreas geográficas
`administrative_area_level_1` `administrative_area_level_2` `country`	`locality` `postal_code` `school_district`
Governo
`city_hall` `courthouse` `embassy` `fire_station` `government_office`	`local_government_office` `neighborhood_police_station` (somente no Japão) `police` `post_office`
Saúde e bem-estar
`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`
Habitação
`apartment_building` `apartment_complex` `condominium_complex` `housing_complex`
Hospedagem
`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`
Elementos naturais
`beach` `island` * `lake` * `mountain_peak` * `nature_preserve` * `river` * `scenic_spot` * `woods` *
Locais de culto
`buddhist_temple` * `church` `hindu_temple` `mosque` `shinto_shrine` * `synagogue`
Serviços
`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` *
Esportes
`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` *
Transporte
`airport` `yakitori_restaurant` * `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`

Tabela B

Os valores de tipo de lugar na Tabela B podem ser retornados como parte de uma resposta de Place Details (novo), Nearby Search (novo), Text Search (novo) ou Autocomplete (novo). Esses tipos também são compatíveis com solicitações de includedPrimaryTypes para o Autocomplete (New).

Outros valores de tipos de lugar
`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`

Tipos de endereço e de componentes de endereço

A matriz types na resposta indica o tipo de endereço. Exemplos de tipos de endereço incluem um endereço de rua, um país ou uma entidade política. A matriz types no campo AddressComponent indica o tipo de cada parte do endereço. Exemplos incluem números de rua ou países.

Os endereços podem ter vários tipos. Os tipos podem ser considerados "tags". Por exemplo, muitas cidades são marcadas com os tipos political e locality.

Os tipos a seguir são aceitos e retornados nas matrizes de tipo de endereço e de componente de endereço:

Tipo de endereço	Descrição
`street_address`	Um endereço preciso.
`route`	Uma rota nomeada (como "US 101").
`intersection`	Uma interseção principal, geralmente de duas vias principais.
`political`	Uma entidade política. Normalmente, esse tipo indica um polígono de administração civil.
`country`	A entidade política nacional, normalmente o tipo de ordem mais alta retornado pelo geocodificador.
`administrative_area_level_1`	Uma entidade civil de primeira ordem, abaixo do nível de país. Nos Estados Unidos, esses níveis administrativos são estados. Nem todos os países incluem esses níveis administrativos. Na maioria dos casos, os nomes curtos de `administrative_area_level_1` vão respeitar quase que totalmente as subdivisões da ISO 3166-2 e outras normas amplamente divulgadas. Porém, isso não é garantido, já que os resultados da nossa geocodificação se baseiam em vários sinais e dados de localização.
`administrative_area_level_2`	Uma entidade civil de segunda ordem, abaixo do nível de país. Nos Estados Unidos, esses níveis administrativos são condados. Nem todos os países incluem esses níveis administrativos.
`administrative_area_level_3`	Uma entidade civil de terceira ordem, abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos.
`administrative_area_level_4`	Uma entidade civil de quarta ordem, abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos.
`administrative_area_level_5`	Uma entidade civil de quinta ordem, abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos.
`administrative_area_level_6`	Uma entidade civil de sexta ordem, abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos.
`administrative_area_level_7`	Uma entidade civil de sétima ordem, abaixo do nível de país. Esse tipo indica uma divisão civil secundária. Nem todos os países incluem esses níveis administrativos.
`colloquial_area`	Um nome alternativo usado comumente para a entidade.
`locality`	Uma entidade política incorporada de cidade ou município.
`sublocality`	Uma entidade civil de primeira ordem, abaixo de uma região administrativa. Para alguns locais, é possível receber um dos tipos adicionais: `sublocality_level_1` até `sublocality_level_5`. Cada nível de sublocalidade é uma entidade civil. Números maiores indicam uma área geográfica menor.
`neighborhood`	Um bairro com nome.
`premise`	Um local nomeado, geralmente um edifício ou um conjunto de edifícios com um nome comum.
`subpremise`	Uma entidade endereçável abaixo do nível do imóvel, como um apartamento, uma unidade ou uma suíte.
`plus_code`	Uma referência de local codificada, derivada de latitude e longitude. Os Plus Codes podem ser usados em vez de endereços nos lugares em que não existem, ou seja, quando os imóveis não estão numerados ou as ruas não têm nome. Para mais detalhes, consulte https://plus.codes.
`postal_code`	Um código postal, como usado para endereçar correspondências no país.
`natural_feature`	Um recurso natural de destaque.
`airport`	Um aeroporto.
`park`	Um parque nomeado.
`point_of_interest`	Um ponto de interesse nomeado. Normalmente, esses "PDIs" são entidades locais de destaque que não se encaixam facilmente em outra categoria, como "Empire State Building" ou "Torre Eiffel".

Uma lista vazia indica que não há tipos conhecidos para um componente de endereço específico, por exemplo, Lieu-dit na França.

Além do indicado acima, os componentes de endereço podem incluir os tipos abaixo.

Tipo de componente de endereço	Descrição
`floor`	O andar de um edifício.
`establishment`	Geralmente, um lugar que ainda não foi categorizado.
`landmark`	Um lugar por perto que é usado como referência para ajudar na navegação.
`point_of_interest`	Um ponto de interesse nomeado.
`parking`	Um estacionamento ou uma estrutura para estacionar.
`post_box`	Uma caixa postal específica.
`postal_town`	Um agrupamento de áreas geográficas, como `locality` e `sublocality`, usado para endereços de correspondência em alguns países.
`room`	A sala de um edifício.
`street_number`	O número exato da rua.
`bus_station`, `train_station` e `transit_station`	O local de uma parada de ônibus, trem ou transporte público.