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

מבוא

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

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

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

ענף הרכב
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 * concert_hall * convention_center cultural_center cycling_park * dance_hall * dog_park event_venue community_center	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

טבלה ב'

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