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

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

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

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

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

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

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

• כחלק מהתשובה של "פרטי מקום (חדש)", "חיפוש בסביבה (חדש)" ו"חיפוש טקסט (חדש)", הערכים בטבלה א' משמשים לאכלוס המאפיין types של המכונה Place. בבקשה צריך לציין Place.Field.TYPES או Place.Field.PRIMARY_TYPE ברשימת השדות.
• כחלק מבקשה של חיפוש בסביבה הקרובה (חדש), משמש כערך של הפרמטרים של הסוגים הכלולים, הסוגים שלא נכללים, הסוגים הראשיים הכלולים והסוגים הראשיים שלא נכללים.
• כחלק מבקשת חיפוש טקסט (חדש), משמש כערך של פרמטר הסוג הכלול.
• כחלק מבקשה של השלמה אוטומטית למקומות (חדש), משתמשים בערכים של הפרמטר primary_types.
• כחלק מתשובה של השלמה אוטומטית למקומות (חדש) שמשמשת לאכלוס מאפיין הסוגים של מופע AutocompletePrediction.

בטבלה ב' מפורטים ערכים נוספים של סוגי מקומות, שיכולים גם להיות מוחזרים כחלק מהתגובה של Place Details (חדש), חיפוש בסביבה (חדש), חיפוש טקסט (חדש) והשלמה אוטומטית למקומות (חדש). הבקשה חייבת לציין את Place.Field.TYPES או את Place.Field.PRIMARY_TYPE ברשימת השדות. אין להשתמש בערכים מטבלה ב' כחלק מבקשה, אלא כערכים של הפרמטר primary types בבקשה להשלמה אוטומטית למקומות (חדש).

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

טבלה א'

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

בריאות וכושר דיור 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 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 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 (חדש), חיפוש בסביבה (חדש), חיפוש טקסט (חדש) או השלמה אוטומטית (חדש). הסוגים האלה נתמכים גם על ידי 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

סוגי כתובות וסוגי רכיבים של כתובות

ה-enum‏ getPlaceTypes בתשובה מציין את סוג הכתובת. דוגמאות לסוגי כתובות: כתובת רחוב, מדינה או ישות פוליטית. המערך types במחלקה AddressComponent מציין את הסוג של כל חלק בכתובת. לדוגמה, מספר בית או מדינה.

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

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

סוג כתובת	תיאור
street_address	כתובת מדויקת.
route	מסלול עם שם (למשל, "כביש 6").
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	נקודת עניין עם שם. בדרך כלל, נקודות העניין האלה הן ישויות מקומיות בולטות שלא מתאימות בקלות לקטגוריה אחרת, כמו "Empire State Building" או "Eiffel Tower".

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

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

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