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), Text Search (Yeni) ve Autocomplete (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.Bir 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 biri olur. - Bir yerle ilişkili Tablo A türü veya Tablo B türünden birden fazla tür değeri 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.
Ayrıca, istek kapsamında yer türlerini de belirtebilirsiniz. İstek içinde 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
A Tablosu, aşağıdaki şekillerde kullanılan türleri listeler:
- Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) yanıtı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ınlarda Arama (Yeni) isteğinin bir parçası olarak
includedTypes,excludedTypes,includedPrimaryTypesveexcludedPrimaryTypesparametresinin değeri olarak kullanılır. Ardından, Tablo B'deki değerler bu alanları doldurmak için kullanılır. - Text Search (New) isteğinin bir parçası olarak
includedTypeparametresinin değeri olarak kullanılır. - Otomatik Tamamlama (Yeni) isteğinin bir parçası olarak,
includedPrimaryTypesparametresinin değerleri olarak kullanın. - Autocomplete (New) yanıtının bir parçası olarak.
B Tablosu, 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ğerlerini listeler. İ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, bir Otomatik Tamamlama (Yeni) isteğinde includedPrimaryTypes parametresinin değeri olarak kullanılabilecek tür koleksiyonlarını listeler. 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ü dizilerinde 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 alanlar | ||
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
|
|
Tablo B
Tablo B'deki yer türü değerleri, Yer Ayrıntıları (New), Yakında Arama (New), Text Search (New) veya Autocomplete (New) 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
|
|
Tablo C
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.
| Type 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ığı yerler için filtreler. |
Adres türleri ve adres bileşeni türleri
Yanıttaki types dizisi, adres türünü belirtir. Adres türlerine örnek olarak sokak adresi, ülke veya siyasi birim 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.
Adresler birden fazla türde 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 kuruluş Genellikle bu tür, bir sivil idarenin poligonunu gösterir. |
country |
Ulusal siyasi varlık ve genellikle Coğrafi Kodlayıcı tarafından döndürülen en yüksek sıralı türdür. |
administrative_area_level_1 |
Ülke düzeyinin altındaki birinci dereceden idari bölgeler. 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 bölgeyi 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ölgeler. Bu tür, küçük bir idari bölgeyi gösterir. 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 bölgeyi gösterir. 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 bölgeyi 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 bölgeyi gösterir. Bu idari düzeyler bazı ülkelerde kullanılmaz. |
colloquial_area |
Tüzel kişi için yaygın olarak kullanılan alternatif bir ad. |
locality |
Tüzel kişiliğe sahip bir şehir veya kasaba siyasi kuruluşu. |
sublocality |
Bir yerleşim biriminin altındaki birinci düzey idari bölge. Bazı konumlarda ek türlerden biri (sublocality_level_1 - sublocality_level_5) gösterilebilir. Her alt yerleşim birimi düzeyi, sivil bir varlıktır. 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 konumdur. Genellikle ortak bir adı olan bir bina veya binalar topluluğudur. |
subpremise |
Tesis düzeyinin altında adreslenebilir bir öğe (ör. apartman, birim veya daire). |
plus_code |
Enlem ve boylamdan elde edilen, kodlanmış bir konum referansı. Plus Kodlar, 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 |
Öne çıkan bir doğal alan. |
airport |
Havalimanı |
park |
Adlandırılmış bir park. |
point_of_interest |
Adlandırılmış bir ö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 bulunduğu 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ış bir ö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 bulunduğu oda. |
street_number |
Tam bina numarası. |
bus_station, train_station ve transit_station |
Otobüs, tren veya toplu taşıma durağının konumu |