סוגי מקומות (חדש)

בחירת פלטפורמה: Android iOS JavaScript Web Service

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

סוגי מקומות הם קטגוריות שמזהות את המאפיינים של מקום. לכל מקום יכול להיות סוג אחד או יותר של מקום.

סוגי המקומות נכללים בתגובה לבקשה של Place Details (חדש), Nearby Search (חדש), Text Search (חדש) ו-Autocomplete (חדש):

למקום יכול להיות סוג ראשי אחד מתוך סוג טבלה א' או סוג טבלה ב' שמשויך אליו. לדוגמה, הסוג הראשי יכול להיות mexican_restaurant או steak_house.יכול להיות שהסוג הראשי לא יופיע אם הסוג הראשי של המקום לא נתמך. אם יש סוג ראשי, הוא תמיד אחד מהסוגים בשדה types.
למקום יכולים להיות משויכים כמה ערכי סוג מהסוג Table A או מהסוג Table B. לדוגמה, למסעדה יכולים להיות הסוגים הבאים: seafood_restaurant, restaurant, food, point_of_interest, establishment.
אפשר לתייג את הכתובת ואת רכיבי הכתובת של מקום מסוים בסוגים מסוימים מתוך הטבלה סוגי כתובות וסוגי רכיבי כתובות. לדוגמה, כתובת יכולה להיות מתויגת כstreet_address ורכיב בכתובת יכול להיות מתויג כstreet_number.

אפשר גם לציין סוגי מקומות כחלק מבקשה. כשמציינים את הסוג בבקשה, הוא משמש כמסנן שמגביל את התגובה כך שתכלול רק מקומות שתואמים לסוגים שצוינו.

מידע על טבלאות הסוגים

בטבלה א' מפורטים הסוגים שמשמשים לדרכים הבאות:

כחלק מתשובה מ-Place Details (New), Nearby Search (New), ו- Text Search (New). בבקשה צריך לציין לפחות אחד מהשדות places.types או places.primaryType במסכת השדות. ‫ הערכים בטבלה א' משמשים לאכלוס השדות האלה.
כחלק מבקשה של חיפוש בקרבת מקום (חדש), משמש כערך של הפרמטרים includedTypes, excludedTypes, includedPrimaryTypes ו-excludedPrimaryTypes. לאחר מכן, המערכת משתמשת בערכים בטבלה ב' כדי לאכלס את השדות האלה.
כחלק מבקשה של חיפוש טקסט (חדש), משמש כערך של הפרמטר includedType.
כחלק מבקשה להשלמה אוטומטית (חדשה), משתמשים בערכים האלה כערכים של הפרמטר includedPrimaryTypes.
כחלק מתשובה של השלמה אוטומטית (חדשה).

בטבלה ב' מפורטים ערכים נוספים של סוגי מקומות שיכולים לחזור גם כחלק מתגובה של Place Details (New),‏ Nearby Search (New),‏ Text Search (New) ו-Autocomplete (New). במסכת השדות של הבקשה צריך לציין לפחות אחד מהשדות places.types או places.primaryType. אסור להשתמש בערכים מטבלה ב' כחלק מבקשה, אלא רק כערכים של הפרמטר includedPrimaryTypes בבקשה של השלמה אוטומטית (חדשה).

סוגי כתובות וסוגי רכיבי כתובות רשימת הסוגים שעשויים להופיע במערכים של סוג הכתובת או סוג רכיב הכתובת, או בשניהם, בגוף התגובה. סוגי רכיבי הכתובת עשויים להשתנות.

טבלה א'

Automotive
עסקים
תרבות
השכלה
בידור ופנאי
מתקנים
Finance
אוכל ומשקאות
אזורים גיאוגרפיים
ממשלה

בריאות ואיכות חיים
Housing
Lodging
מאפייני השטח הטבעי
בתי תפילה
שירותים
שופינג
ספורט
תחבורה

ענף הרכב
`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` *
עסקי
`business_center` * `corporate_office` `coworking_space` * `farm` `manufacturer` * `ranch` `supplier` * `television_studio` *
תרבות
`art_gallery` `art_museum` * `art_studio` `auditorium` `castle` * `cultural_landmark` `fountain` * `historical_place` `history_museum` *	`monument` `museum` `performing_arts_theater` `sculpture`
חינוך
`academic_department` * `educational_institution` * `library` `preschool` `primary_school`	`research_institute` * `school` `secondary_school` `university`
בידור ופנאי
`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`
אזורים ציבוריים
`public_bath` `public_bathroom` `stable`
פיננסים
`accounting` `atm` `bank`
מזון ומשקאות
`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` *
אזורים גיאוגרפיים
`administrative_area_level_1` `administrative_area_level_2` `country`	`locality` `postal_code` `school_district`
ממשל
`city_hall` `courthouse` `embassy` `fire_station` `government_office`	`local_government_office` `neighborhood_police_station` (יפן בלבד) `police` `post_office`
בריאות ואיכות חיים
`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`
דיור
`apartment_building` `apartment_complex` `condominium_complex` `housing_complex`
לינה
`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`
מאפייני השטח הטבעי
`beach` `island` * `lake` * `mountain_peak` * `nature_preserve` * `river` * `scenic_spot` * `woods` *
בתי-תפילה
`buddhist_temple` * `church` `hindu_temple` `mosque` `shinto_shrine` * `synagogue`
שירותים
`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`
קניות
`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` *
ספורט
`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` *
תחבורה
`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`

טבלה ב'

הערכים של סוג המקום בטבלה ב' עשויים לחזור כחלק מתגובה של Place Details (חדש), Nearby Search (חדש), Text Search (חדש) או Autocomplete (חדש). הסוגים האלה נתמכים גם ב-includedPrimaryTypes לבקשות של השלמה אוטומטית (חדשה).

ערכים נוספים של סוג המקום
`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 בתגובה מציין את סוג הכתובת. דוגמאות לסוגי כתובות כוללות כתובת רחוב, מדינה או ישות פוליטית. המערך types בשדה AddressComponent מציין את הסוג של כל חלק בכתובת. לדוגמה, מספר בית או מדינה.

יכולים להיות כמה סוגים של כתובות. אפשר להתייחס לסוגים האלה כאל 'תגים'. לדוגמה, ערים רבות מתויגות בסוגים political ו-locality.

הסוגים הבאים נתמכים ומוחזרים במערכים של סוג הכתובת וסוג רכיב הכתובת:

סוג כתובת	תיאור
`street_address`	כתובת מדויקת.
`route`	מסלול עם שם (לדוגמה, כביש 101 בארה"ב).
`intersection`	צומת גדול, בדרך כלל של שני כבישים ראשיים.
`political`	ישות פוליטית. בדרך כלל, הסוג הזה מציין מצולע של איזושהי רשות אזרחית.
`country`	הישות הפוליטית הלאומית, ובדרך כלל זהו הסוג ברמה הכי גבוהה שמוחזר על ידי הגיאוקודר.
`administrative_area_level_1`	חלוקה מנהלית מדרגה ראשונה מתחת לרמה הארצית. בארצות הברית, הרמות האדמיניסטרטיביות האלה הן מדינות. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה. ברוב המקרים, `administrative_area_level_1` שמות קצרים יהיו דומים מאוד לחלוקות משנה של ISO 3166-2 ולרשימות אחרות שמופצות באופן נרחב. עם זאת, אין בכך ערובה, כי תוצאות הגיאו-קידוד שלנו מבוססות על מגוון אותות ונתוני מיקום.
`administrative_area_level_2`	חלוקה מנהלית מדרגה שנייה מתחת לרמה הארצית. בארצות הברית, הרמות האדמיניסטרטיביות האלה הן מחוזות. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`administrative_area_level_3`	חלוקה מנהלית מדרגה שלישית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`administrative_area_level_4`	חלוקה מנהלית מדרגה רביעית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`administrative_area_level_5`	חלוקה מנהלית מדרגה חמישית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`administrative_area_level_6`	חלוקה מנהלית מדרגה שישית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`administrative_area_level_7`	חלוקה מנהלית מדרגה שביעית מתחת לרמה הארצית. הסוג הזה מציין חלוקה אזרחית משנית. לא בכל הארצות יש רמות אדמיניסטרטיביות כאלה.
`colloquial_area`	שם חלופי שמשמש בדרך כלל להתייחסות לישות.
`locality`	ישות פוליטית של עיר או עיירה מאוגדת.
`sublocality`	חלוקה מנהלית מדרגה ראשונה מתחת לרמת היישוב. יכול להיות שחלק מהמיקומים יקבלו אחד מהסוגים הנוספים: `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`	נקודת עניין עם שם. בדרך כלל, ה-POI האלה הם ישויות מקומיות בולטות שלא מתאימות בקלות לקטגוריה אחרת, כמו 'אמפייר סטייט בילדינג' או 'מגדל אייפל'.

רשימה ריקה של סוגים מציינת שאין סוגים ידועים לרכיב הכתובת הספציפי (לדוגמה, Lieu-dit בצרפת).

בנוסף לאלה שלמעלה, רכיבי כתובת יכולים לכלול את הסוגים שמפורטים בהמשך.

סוג רכיב בכתובת	תיאור
`floor`	הקומה בכתובת של הבניין.
`establishment`	בדרך כלל מדובר במקום שעדיין לא סווג.
`landmark`	מקום סמוך שמשמש כנקודת התייחסות כדי לעזור בניווט.
`point_of_interest`	נקודת עניין עם שם.
`parking`	חניון או מגרש חניה.
`post_box`	תא דואר ספציפי.
`postal_town`	קבוצה של אזורים גיאוגרפיים, כמו `locality` ו-`sublocality`, שמשמשת לכתובות למשלוח דואר במדינות מסוימות.
`room`	החדר בכתובת הבניין.
`street_number`	מספר הבית המדויק.
`bus_station`,‏ `train_station` וגם `transit_station`	המיקום של תחנת אוטובוס, רכבת או תחבורה ציבורית.