Tipos de locais

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 street_address, e um componente dele pode ser marcado como 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 valores compatíveis com tipos de lugar:

• Como parte de uma resposta de Place Details (novo), Nearby Search (novo) e Text Search (novo). 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 do widget Place Autocomplete (novo), usada como os valores do parâmetro includedPrimaryTypes.
• Como parte de uma resposta do widget Place 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 widget Place 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 do widget Place Autocomplete (novo).

A lista Tipos de endereço e de componentes de endereço mostra os tipos que podem aparecer em uma ou nas duas matrizes de tipo de endereço e 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 Imóveis * Hospedagem Recursos naturais * Locais de culto Serviços Compras Esportes Transporte

Automotivo
car_dealer car_rental car_repair car_wash	electric_vehicle_charging_station gas_station parking rest_stop
Negócios
corporate_office * farm ranch *
Cultura
art_gallery art_studio * auditorium * cultural_landmark * historical_place *	monument * museum performing_arts_theater sculpture *
Educação
library preschool primary_school	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 * 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
Instalações
public_bath * public_bathroom * stable *
Finanças
accounting atm bank
Alimentos e bebidas
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 *
Á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 hospital massage * 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 *
Locais de culto
church hindu_temple mosque synagogue
Serviços
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
Compras
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
Esportes
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
Transporte
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

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 na classe google.maps.places.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 nos arrays 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 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 listados 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 classificado.
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.