מבוא
סוגי מקומות הם קטגוריות שמזהות את המאפיינים של מקום. למקום יכולים להיות כמה סוגים.
סוגי המקומות נכללים בתגובה לבקשה של Place Details (חדש), חיפוש בסביבה (חדש), חיפוש טקסט (חדש) והשלמה אוטומטית (חדש):
- למקום יכול להיות סוג ראשי אחד מטבלה א' או מטבלה ב' שמשויך אליו.
לדוגמה, הסוג הראשי יכול להיות
mexican_restaurantאוsteak_house.יכול להיות שהסוג הראשי לא יופיע אם הסוג הראשי של המקום לא נתמך. אם יש סוג ראשי, הוא תמיד אחד מהסוגים בשדהtypes. - למקום יכולים להיות כמה ערכי סוגים מסוג טבלה א' או מסוג טבלה ב' שמשויכים אליו.
לדוגמה, למסעדה יכולים להיות הסוגים הבאים:
seafood_restaurant,restaurant,food,point_of_interest,establishment. - אפשר לתייג את הכתובת ואת רכיבי הכתובת של מקום מסוים באמצעות סוגים מסוימים מהטבלה סוגי כתובות וסוגי רכיבי כתובות. לדוגמה, כתובת יכולה להיות מתויגת בתור
street_addressורכיב של הכתובת יכול להיות מתויג בתורstreet_number.
אפשר גם לציין סוגי מקומות כחלק מבקשה. כשמציינים את הסוג בבקשה, הוא פועל כמסנן שמגביל את התגובה כך שתכלול רק מקומות שתואמים לסוגים שצוינו.
מידע על טבלאות הסוגים
בטבלה א' מפורטים הסוגים שמשמשים בדרכים הבאות:
- כחלק מתגובה מ-Place Details (חדש), חיפוש בסביבה (חדש) וחיפוש טקסט (חדש). הבקשה חייבת לציין לפחות אחד מהשדות
places.typesאוplaces.primaryTypeבמסכת השדות. הערכים בטבלה א' משמשים לאכלוס השדות האלה. - כחלק מבקשה של חיפוש בסביבה (חדש), משמש כערך של הפרמטרים
includedTypes,excludedTypes,includedPrimaryTypesו-excludedPrimaryTypes. הערכים בטבלה ב' משמשים לאכלוס השדות האלה. - כחלק מבקשה של חיפוש טקסט (חדש), משמש כערך של הפרמטר
includedType. - כחלק מבקשת Autocomplete (חדש), משתמשים בערכים של הפרמטר
includedPrimaryTypes. - כחלק מתשובה של Autocomplete (New).
בטבלה ב' מפורטים ערכים נוספים של סוגי מקומות שעשויים להופיע גם בתגובה של Place Details (חדש), Nearby Search (חדש), Text Search (חדש) ו-Autocomplete (חדש). בבקשה צריך לציין לפחות אחד מהשדות places.types או places.primaryType במסכת השדות. אי אפשר להשתמש בערכים מטבלה ב' כחלק מבקשה, חוץ מאשר כערכים של הפרמטר includedPrimaryTypes בבקשה להשלמה אוטומטית (חדשה).
בטבלה ג' מפורטים אוספי סוגים שאפשר להשתמש בהם כערך של הפרמטר includedPrimaryTypes בבקשה להשלמה אוטומטית (חדשה). אי אפשר לציין אוספי סוגים עם ערכים מסוגים אחרים.
סוגי כתובות וסוגי רכיבי כתובות מפרט את הסוגים שעשויים להופיע במערכים של סוגי הכתובות וסוגי רכיבי הכתובות בגוף התגובה. סוגי הרכיבים של הכתובת עשויים להשתנות.
טבלה א'
| כלי רכב | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| עסקי | ||
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_refugezoo
|
| אזורים ציבוריים | ||
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 * |
|
| תחבורה | ||
airportairstripbike_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
|
|
טבלה ב'
ערכי סוגי המקומות בטבלה ב' יכולים להיות מוחזרים כחלק מתגובה של פרטי מקום (חדש), חיפוש בסביבה (חדש), חיפוש טקסט (חדש) או השלמה אוטומטית (חדש). הסוגים האלה נתמכים גם על ידי 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
|
|
טבלה ג'
אפשר להשתמש באוספי סוגים בתור הערך של includedPrimaryTypes בבקשות של השלמה אוטומטית (חדשה). אם משתמשים באוסף סוגים, מוחזרות כל התוצאות שתואמות לאחד מהסוגים המשויכים שנכללים. אי אפשר לציין אוספי סוגים עם ערכי סוגים אחרים.
| אוסף גופנים | סוגים כלולים |
|---|---|
(regions) |
מסננים לאזורים או לחלוקות, כמו שכונות ומיקודים. |
(cities) |
מסננים למקומות ש-Google מזהה כעיר. |
סוגי כתובות וסוגי רכיבים של כתובות
המערך types בתגובה מציין את סוג הכתובת. דוגמאות לסוגי כתובות: כתובת רחוב, מדינה או ישות פוליטית. המערך types בשדה AddressComponent מציין את הסוג של כל חלק בכתובת. לדוגמה, מספר בית או מדינה.
לכתובות יכולים להיות כמה סוגים. אפשר להתייחס לסוגים כאל "תגים".
לדוגמה, ערים רבות מתויגות בסוגים political ו-locality.
הסוגים הבאים נתמכים ומוחזרים גם במערכים של סוג הכתובת וגם במערכים של סוג רכיב הכתובת:
| סוג כתובת | תיאור |
|---|---|
street_address |
כתובת מדויקת. |
route |
מסלול עם שם (למשל, "כביש 6"). |
intersection |
צומת ראשי, בדרך כלל של שני כבישים ראשיים. |
political |
ישות פוליטית. בדרך כלל, הסוג הזה מציין פוליגון של מנהל אזרחי כלשהו. |
country |
הישות הפוליטית הלאומית, ובדרך כלל סוג הסדר הגבוה ביותר שמוחזר על ידי הכלי להמרת כתובות לקואורדינטות (geocoder). |
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 |
המיקום של תחנת אוטובוס, רכבת או תחבורה ציבורית. |