Giriş
Yer türleri, bir yerin özelliklerini tanımlayan kategorilerdir. Bir yere bir veya daha fazla yer türü atanabilir.
Bir yerin türleri; Yer Ayrıntıları (Yeni), Yakında Arama (Yeni), Metin Arama (Yeni) ve Otomatik Tamamlama (Yeni) isteğinden gelen yanıta dahil edilir:
- Bir yer, Tablo A veya Tablo B türünden tek bir birincil türe sahip olabilir.
Örneğin, birincil tür
mexican_restaurantveyasteak_houseolabilir. Yerin birincil türü desteklenen bir tür değilse birincil tür eksik olabilir. Birincil tür mevcut olduğunda her zamantypesalanındaki türlerden biridir. - Bir yer, Tablo A veya Tablo B türünden birden fazla tür değerine sahip olabilir.
Örneğin, bir restoran şu türlere sahip olabilir:
seafood_restaurant,restaurant,food,point_of_interest,establishment. - Bir yerin adresi ve adres bileşenleri, Adres türleri ve adres bileşeni türleri tablosundaki belirli türlerle etiketlenebilir. Örneğin, bir adres
street_addressolarak etiketlenebilir ve adresin bir bileşenistreet_numberolarak etiketlenebilir.
Yer türlerini bir isteğin parçası olarak da belirtebilirsiniz. İstekte belirtildiğinde tür, yanıtı yalnızca belirtilen türlerle eşleşen yerleri içerecek şekilde kısıtlayan bir filtre görevi görür.
Tür tabloları hakkında
Tablo A'da, aşağıdaki şekillerde kullanılan türler listelenmiştir:
- Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) yanıtlarının bir parçası olarak. İstek, alan maskesinde
places.typesveyaplaces.primaryTypealanlarından en az birini belirtmelidir. Ardından, bu alanları doldurmak için Tablo A'daki değerler kullanılır. - Yakında Arama (Yeni) isteğinin bir parçası olarak
includedTypes,excludedTypes,includedPrimaryTypesveexcludedPrimaryTypesparametresinin değeri olarak kullanılır. Ardından, bu alanları doldurmak için B tablosundaki değerler kullanılır. - Text Search (New) isteğinin bir parçası olarak
includedTypeparametresinin değeri olarak kullanılır. - Autocomplete (New) isteğinin bir parçası olarak
includedPrimaryTypesparametresinin değerleri olarak kullanın. - Autocomplete (New) yanıtının bir parçası olarak.
Tablo B'de, Yer Ayrıntıları (Yeni), Yakında Arama (Yeni), Metin Arama (Yeni) ve Otomatik Tamamlama (Yeni) yanıtının bir parçası olarak da döndürülebilecek ek yer türü değerleri listelenir. İstek, alan maskesinde places.types veya places.primaryType alanlarından en az birini belirtmelidir. B Tablosu'ndaki değerler, Otomatik Tamamlama (Yeni) isteği için includedPrimaryTypes parametresinin değerleri dışında bir isteğin parçası olarak KULLANILAMAZ.
Tablo C'de, Otomatik Tamamlama (Yeni) isteğindeki includedPrimaryTypes parametresinin değeri olarak kullanılabilecek tür koleksiyonları listelenir. Tür koleksiyonları, başka tür değerleriyle belirtilemez.
Adres türleri ve adres bileşeni türleri, yanıt gövdesindeki adres türü ve adres bileşeni türü dizilerinden birinde veya her ikisinde görünebilecek türleri listeler. Adres bileşeni türleri değişebilir.
Tablo A
| Otomotiv | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_washebike_charging_station *electric_vehicle_charging_stationgas_station |
parkingparking_garage *parking_lot *rest_stoptire_shop *truck_dealer * |
|
| İşletme | ||
business_center *corporate_officecoworking_space *farmmanufacturer *ranchsupplier *television_studio * |
||
| Kültür | ||
art_galleryart_museum *art_studioauditoriumcastle *cultural_landmarkfountain *historical_placehistory_museum * |
monumentmuseumperforming_arts_theatersculpture |
|
| Eğitim | ||
academic_department *educational_institution *librarypreschoolprimary_school |
research_institute *schoolsecondary_schooluniversity |
|
| Eğlence ve Dinlence Merkezi | ||
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
|
| Tesisler | ||
public_bathpublic_bathroomstable
|
||
| Finans | ||
accountingatmbank
|
||
| Yiyecek ve İçecek | ||
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 * |
| Coğrafi Alanlar | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Resmi Kurumlar | ||
city_hallcourthouseembassyfire_stationgovernment_office
|
local_government_officeneighborhood_police_station (Yalnızca Japonya)policepost_office
|
|
| Sağlık ve Zindelik | ||
chiropractordental_clinicdentistdoctordrugstoregeneral_hospital *hospitalmassagemassage_spa *medical_center *medical_clinic *medical_lab
|
pharmacyphysiotherapistsaunaskin_care_clinicspatanning_studiowellness_centeryoga_studio
|
|
| Konut | ||
apartment_buildingapartment_complexcondominium_complexhousing_complex
|
||
| Konaklama | ||
bed_and_breakfastbudget_japanese_inncampgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostelhotel |
innjapanese_innlodgingmobile_home_parkmotelprivate_guest_roomresort_hotelrv_park
|
|
| Doğal Özellikler | ||
beachisland *lake *mountain_peak *nature_preserve *river *scenic_spot *woods * |
||
| İbadet Yerleri | ||
buddhist_temple *churchhindu_templemosqueshinto_shrine *synagogue
|
||
| Hizmetler | ||
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
|
|
| Alışveriş | ||
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 * |
|
| Spor | ||
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 * |
|
| Ulaşım | ||
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
|
|
B Tablosu
Tablo B'deki yer türü değerleri; Yer Ayrıntıları (Yeni), Yakında Arama (Yeni), Metin Arama (Yeni) veya Otomatik Tamamlama (Yeni) yanıtının bir parçası olarak döndürülebilir. Bu türler, Otomatik Tamamlama (Yeni) istekleri için includedPrimaryTypes tarafından da desteklenir.
| Ek yer türü değerleri | ||
|---|---|---|
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
|
|
C Tablosu
Tür koleksiyonları, Otomatik Tamamlama (Yeni) isteklerinde includedPrimaryTypes değeri olarak kullanılabilir. Tür koleksiyonu kullanıldığında, ilişkili dahil edilen türlerden herhangi biriyle eşleşen tüm sonuçlar döndürülür. Tür koleksiyonları başka tür değerleriyle belirtilemez.
| Yazı tipi koleksiyonu | Dahil edilen türler |
|---|---|
(regions) |
Mahalleler ve posta kodları gibi alanlar veya bölümler için filtreler. |
(cities) |
Google'ın şehir olarak tanımladığı yerleri filtreler. |
Adres türleri ve adres bileşeni türleri
Yanıttaki types dizisi, adres türünü gösterir. Adres türlerine örnek olarak açık adres, ülke veya siyasi bir varlık verilebilir. AddressComponent alanındaki types dizisi, adresin her bir bölümünün türünü belirtir. Bina numarası veya ülke buna örnek olarak verilebilir.
Adreslerin birden fazla türü olabilir. Türler "etiket" olarak kabul edilebilir.
Örneğin, birçok şehir political ve locality türleriyle etiketlenir.
Aşağıdaki türler desteklenir ve hem adres türü hem de adres bileşeni türü dizilerinde döndürülür:
| Adres Türü | Açıklama |
|---|---|
street_address |
Tam açık adres. |
route |
Adlandırılmış bir rota (ör. "US 101"). |
intersection |
Genellikle iki ana yolun kesiştiği büyük bir kavşak. |
political |
Siyasi bir tüzel kişi Bu tür genellikle bir sivil idarenin poligonunu gösterir. |
country |
Ulusal siyasi varlık. Genellikle Coğrafi Kodlayıcı tarafından döndürülen en yüksek düzeydeki türdür. |
administrative_area_level_1 |
Ülke düzeyinin altındaki birinci dereceden idari bölge. Amerika Birleşik Devletleri'nde bu idari düzeyler eyaletlerdir. Bu idari düzeyler bazı ülkelerde kullanılmaz. Çoğu durumda administrative_area_level_1 kısa adları, ISO 3166-2 alt bölümleri ve yaygın olarak kullanılan diğer listelerle yakından eşleşir. Ancak coğrafi kodlama sonuçlarımız çeşitli sinyallere ve konum verilerine dayandığından bu durum garanti edilmez. |
administrative_area_level_2 |
Ülke düzeyinin altındaki ikinci dereceden idari bölge. Amerika Birleşik Devletleri'nde bu idari düzeyler ilçelerdir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
administrative_area_level_3 |
Ülke düzeyinin altındaki üçüncü düzey idari bölge. Bu tür, küçük bir idari birimi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
administrative_area_level_4 |
Ülke düzeyinin altındaki dördüncü düzey idari bölge. Bu tür, küçük bir idari birimi belirtir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
administrative_area_level_5 |
Ülke düzeyinin altındaki beşinci düzey idari bölge. Bu tür, küçük bir idari birimi belirtir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
administrative_area_level_6 |
Ülke düzeyinin altındaki altıncı düzey idari bölge. Bu tür, küçük bir idari birimi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
administrative_area_level_7 |
Ülke düzeyinin altındaki yedinci düzey idari bölge. Bu tür, küçük bir idari birimi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
colloquial_area |
Varlığın yaygın olarak kullanılan alternatif adı. |
locality |
Anonim bir şehir veya kasaba siyasi kuruluşu. |
sublocality |
Bir yerleşim yerinin altındaki birinci dereceden idari bölge. Bazı konumlar, ek türlerden birini alabilir: sublocality_level_1 - sublocality_level_5. Her alt semt düzeyi bir sivil tüzel kişidir. Daha büyük sayılar daha küçük bir coğrafi alanı gösterir. |
neighborhood |
Adlandırılmış bir mahalle. |
premise |
Adlandırılmış bir konum. Genellikle bir bina veya ortak adı olan bir bina grubudur. |
subpremise |
Tesis düzeyinin altında, adreslenebilir bir varlık (ör. apartman dairesi, birim veya süit). |
plus_code |
Enlem ve boylamdan türetilen, kodlanmış bir konum referansı. Plus Code'lar, açık adreslerin bulunmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) açık adreslerin yerine kullanılabilir. Ayrıntılar için https://plus.codes adresini ziyaret edin. |
postal_code |
Ülke içinde posta göndermek için kullanılan posta kodu. |
natural_feature |
Önemli bir doğal özellik. |
airport |
Havaalanı. |
park |
Adlandırılmış bir park. |
point_of_interest |
Adlandırılmış önemli yer. Genellikle bu "ÖY"ler, "Empire State Binası" veya "Eyfel Kulesi" gibi başka bir kategoriye kolayca uymayan önemli yerel öğelerdir. |
Boş bir tür listesi, belirli adres bileşeni için bilinen bir tür olmadığını gösterir (örneğin, Fransa'da Lieu-dit).
Yukarıdakilere ek olarak, adres bileşenleri aşağıda listelenen türleri içerebilir.
| Adres Bileşeni Türü | Açıklama |
|---|---|
floor |
Bina adresinin katı. |
establishment |
Genellikle henüz kategorize edilmemiş bir yerdir. |
landmark |
Navigasyona yardımcı olmak için referans olarak kullanılan yakındaki bir yer. |
point_of_interest |
Adlandırılmış önemli yer. |
parking |
Otopark veya katlı otopark. |
post_box |
Belirli bir posta kutusu. |
postal_town |
Bazı ülkelerde posta adresleri için kullanılan, locality ve sublocality gibi coğrafi alanların gruplandırılması. |
room |
Bina adresinin oda bilgisi. |
street_number |
Tam sokak numarası. |
bus_station, train_station ve transit_station |
Otobüs, tren veya toplu taşıma durağının konumu. |