סוגי מקומות

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

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

סוגי המקומות נכללים בתגובה לבקשה של פרטי מקום (חדש), חיפוש בקרבת מקום (חדש), חיפוש טקסט (חדש) והשלמה אוטומטית (חדש):

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

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

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

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

• כחלק מתשובה מ'פרטי המקום' (חדש), מ'חיפוש בקרבת מקום' (חדש) ומ'חיפוש טקסט' (חדש). לאחר מכן, הערכים בטבלה א' משמשים לאכלוס השדות האלה.
• כחלק מבקשה של חיפוש בקרבת מקום (חדש), משמש בתור הערך של הפרמטרים includedTypes,‏ excludedTypes,‏ includedPrimaryTypes ו-excludedPrimaryTypes. לאחר מכן, הערכים בטבלה ב' משמשים לאכלוס השדות האלה.
• כחלק מבקשה של חיפוש טקסט (חדש), משמש כערך של הפרמטר includedType.
• כחלק מבקשה של ווידג'ט של השלמה אוטומטית של מקומות (חדש), אפשר להשתמש בערכים האלה לפרמטר includedPrimaryTypes.
• כחלק מתשובה של ווידג'ט של השלמה אוטומטית של מקום (חדש).

טבלה ב' מציגה ערכים נוספים של סוג מקום שיכולים להופיע גם בתגובה של 'פרטי המקום' (חדש), 'חיפוש בקרבת מקום' (חדש), 'חיפוש טקסט' (חדש) ו'ווידג'ט של השלמה אוטומטית של מקום' (חדש). בבקשה צריך לציין לפחות אחד מהשדות places.types או places.primaryType במסכת השדות. אסור להשתמש בערכים מטבלה ב' כחלק מבקשה, מלבד כערכים של הפרמטר includedPrimaryTypes בבקשה של ווידג'ט להשלמה אוטומטית של מקומות (חדש).

Address types and address component types (סוגי כתובות וסוגים של רכיבי כתובת) – רשימה של סוגי הפריטים שעשויים להופיע במערך של סוגי הכתובות או במערך של סוגי רכיבי הכתובת בגוף התגובה. סוגי הרכיבים של הכתובת עשויים להשתנות.

טבלה א'

הערה: הסוגים עם הכוכבית (*) נוספו במסגרת הגרסה שפורסמה ב-7 בנובמבר 2024.

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

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

ענף הרכב
car_dealer car_rental car_repair car_wash	electric_vehicle_charging_station gas_station parking rest_stop
עסקי
corporate_office * farm ranch *
תרבות
art_gallery art_studio * auditorium * cultural_landmark * historical_place *	monument * museum performing_arts_theater sculpture *
חינוך
library preschool primary_school	school secondary_school university
בידור ופנאי
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
אזורים ציבוריים
public_bath * public_bathroom * stable *
פיננסים
accounting atm bank
מזון ומשקאות
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 *
אזורים גיאוגרפיים
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 hospital massage * 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 *
בתי-תפילה
church hindu_temple mosque synagogue
שירותים
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
קניות
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
ספורט
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
תחבורה
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

טבלה ב'

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

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

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

הערה: הרשימה הזו אינה מלאה ועלולה להשתנות.

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