はじめに
プレイスタイプは、場所の特性を識別するカテゴリです。1 つの場所に 1 つ以上の場所タイプを割り当てることができます。
場所のタイプは、Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)、予測入力(新版)のリクエストからのレスポンスに含まれています。
- プレイスには、タイプ 表 A またはタイプ 表 B の単一のプライマリ タイプを関連付けることができます。たとえば、プライマリ タイプは
mexican_restaurantまたはsteak_houseになります。場所のプライマリ タイプがサポートされているタイプでない場合、プライマリ タイプは欠落している可能性があります。プライマリ タイプが存在する場合、それは常にtypesフィールドのタイプの 1 つです。 - 場所には、タイプ 表 A またはタイプ 表 B の複数のタイプ値を関連付けることができます。たとえば、レストランには
seafood_restaurant、restaurant、food、point_of_interest、establishmentなどのタイプがあります。 - 場所の住所と住所コンポーネントには、住所のタイプと住所コンポーネントのタイプの表にある特定のタイプをタグ付けできます。たとえば、アドレスに
street_addressのタグが付けられ、アドレスのコンポーネントにstreet_numberのタグが付けられることがあります。
リクエストの一部として、場所のタイプを指定することもできます。リクエストで指定すると、タイプはフィルタとして機能し、指定されたタイプに一致する場所のみがレスポンスに含まれるように制限します。
型テーブルについて
テーブル A には、次のように使用されるタイプが挙げられています。
- Place Details(新版)、Nearby Search(新版)、およびテキスト検索(新版)からのレスポンスの一部として返されます。リクエストでは、フィールド マスクに
places.typesフィールドまたはplaces.primaryTypeフィールドの少なくとも 1 つを指定する必要があります。次に、テーブル A の値を使用して、これらのフィールドに値が入力されます。 - Nearby Search(新版)リクエストの
includedTypes、excludedTypes、includedPrimaryTypes、excludedPrimaryTypesのパラメータの値として使用されます。次に、テーブル B の値を使用して、これらのフィールドに値が入力されます。 - テキスト検索(新版)リクエストの
includedTypeパラメータの値として使用されます。 - Autocomplete(新版)リクエストの
includedPrimaryTypesパラメータの値として使用されます。 - Autocomplete(新版)レスポンスの一部として返されます。
テーブル B には、追加の場所タイプの値が挙げられています。これらの値も Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)、および Autocomplete(新版)のレスポンスの一部として返される場合があります。リクエストでは、フィールド マスクに places.types フィールドまたは places.primaryType フィールドの少なくとも 1 つを指定する必要があります。テーブル B の値は、Autocomplete(新版)リクエストの includedPrimaryTypes パラメータの値として使用する場合を除き、リクエストの一部として使用することはできません。
住所のタイプと住所コンポーネントのタイプは、レスポンス本文の住所のタイプと住所コンポーネントのタイプのいずれかまたは両方の配列に表示される可能性のあるタイプのリストです。住所コンポーネントのタイプは変更される可能性があります。
テーブル A
| 自動車 | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| Business | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| 文化 | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| 教育 | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| エンターテイメント/レクリエーション | ||
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_refugewinery *zoo
|
| 施設 | ||
public_bathpublic_bathroomstable
|
||
| 金融 | ||
accountingatmbank
|
||
| フード、ドリンク | ||
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 * |
| 地理的エリア | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| 政府機関 | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station(日本のみ)policepost_office
|
|
| 健康とウェルネス | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| 住宅 | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| 宿泊施設 | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| 自然地物 | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| 礼拝所 | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| サービス | ||
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
|
|
| ショッピング | ||
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 * |
|
| スポーツ | ||
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 * |
|
| 交通 | ||
airportyakitori_restaurant *airstripbike_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
|
|
テーブル B
テーブル B の場所タイプの値は、Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)、または Autocomplete(新版)のレスポンスの一部として返される場合があります。これらのタイプは、Autocomplete(New)リクエストの includedPrimaryTypes でもサポートされています。
| 場所タイプの追加の値 | ||
|---|---|---|
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 配列は、住所タイプを示します。住所の種類の例としては、番地、国、行政区画などがあります。AddressComponent フィールドの types 配列は、住所の各部分のタイプを示します。たとえば、国や番地などです
住所には複数のタイプがあります。これらのタイプは「タグ」とみなすことができます。たとえば、多くの都市には political タイプと locality タイプのタグが付けられています。
ジオコーダでは、次のタイプは住所タイプと住所コンポーネント タイプの両方でサポートされており、返されます。
| アドレスの種類 | 説明 |
|---|---|
street_address |
正確な番地。 |
route |
名前のある道路(US 101 など)。 |
intersection |
主要交差点(通常は 2 つの大通りの交差点)。 |
political |
政治団体。通常、このタイプは民政のポリゴンを示します。 |
country |
国レベルの行政区画。一般的にはジオコーダから返される最上位のタイプです。 |
administrative_area_level_1 |
国の 1 段階下の行政区画。米国の場合、この行政上のレベルは州です。すべての国でこの行政区画レベルが存在するわけではありません。多くの場合、administrative_area_level_1 の省略名は下位区分 ISO 3166-2 とその他の一般的なリストに一致します。ただし、Google のジオコーディングの結果はさまざまな信号と位置情報データに基づいているため、これらの名前が厳密に一致するとは限りません。 |
administrative_area_level_2 |
国の 2 段階下の行政区画。米国の場合、この行政上のレベルは郡です。すべての国でこの行政区画レベルが存在するわけではありません。 |
administrative_area_level_3 |
国の 3 段階下の行政区画。このタイプは小規模な行政上の区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。 |
administrative_area_level_4 |
国の 4 段階下の行政区画。このタイプは小規模な行政上の区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。 |
administrative_area_level_5 |
国の 5 段階下の行政区画。このタイプは小規模な行政上の区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。 |
administrative_area_level_6 |
国の 6 段階下の行政区画。このタイプは小規模な行政上の区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。 |
administrative_area_level_7 |
国の 7 段階下の行政区画。このタイプは小規模な行政上の区域を示します。すべての国でこの行政区画レベルが存在するわけではありません。 |
colloquial_area |
一般的に使用されている通称。 |
locality |
行政区画である都市または町。 |
sublocality |
locality の 1 段階下の行政区画。一部の場所では、sublocality_level_1 から sublocality_level_5 のいずれかの追加タイプを受け取ります。各下位地区レベルは行政区画で、数が大きいほど区域は小さくなります。 |
neighborhood |
名前のある近隣地域。 |
premise |
名前のある場所。通常は共通の名前を持つ建物や建物の集合体です。 |
subpremise |
建物レベル以下の住所指定可能なエンティティ(アパート、棟、部屋など)。 |
plus_code |
エンコードされた場所の参照情報。緯度と経度に基づきます。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。詳しくは https://plus.codes をご覧ください。 |
postal_code |
対象の国内で郵便物の宛先として使用される郵便番号。 |
natural_feature |
特徴的な地勢。 |
airport |
空港。 |
park |
名前付きの公園。 |
point_of_interest |
名前のあるスポット。通常、これらの「スポット」は、その地域で有名な場所のことを指し、「エンパイア ステートビル」や「エッフェル塔」など、他のカテゴリにはあまり当てはまらないものです。 |
タイプリストが空の場合は、特定の住所コンポーネントに対して既知のタイプが存在しないことを意味します(たとえば、フランスのリュディがこれに相当します)。
上記の他に、住所コンポーネントには以下のタイプが含まれることがあります。
| 住所コンポーネントのタイプ | 説明 |
|---|---|
floor |
建物の住所の階数。 |
establishment |
通常は、まだ分類されていない場所です。 |
landmark |
ナビゲーションを支援するために参照として使用される付近の場所。 |
point_of_interest |
名前のあるスポット。 |
parking |
駐車場または立体駐車場。 |
post_box |
特定の郵便ポスト。 |
postal_town |
locality や sublocality など、一部の国で郵送先住所に使用される地域グループ。 |
room |
建物の部屋。 |
street_number |
正確な番地。 |
bus_station、train_station、transit_station |
バス、電車、公共交通機関の停留所の位置。 |