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ürlerinden 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ın şu türleri 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ürleri 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. A tablosundaki değerler daha sonra bu alanları doldurmak için kullanılır. - Yakın Çevrede 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. - Bir Metin Arama (Yeni) isteğinin 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. - Otomatik Tamamlama (Yeni) 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. Tablo B'deki değerler, bir istek kapsamında kullanılamaz. Ancak Otomatik Tamamlama (Yeni) isteği için includedPrimaryTypes parametresinin değerleri olarak kullanılabilir.
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_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| İşletme | ||
corporate_office *farmranch * |
||
| Kültür | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| Eğitim | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| Eğlence ve Dinlence Merkezi | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue |
ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo
|
| Tesisler | ||
public_bath *public_bathroom *stable *
|
||
| Finans | ||
accountingatmbank
|
||
| Yiyecek ve İçecek | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant |
mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar *
|
| 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 | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| Konut | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| Konaklama | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| Doğal Alanlar | ||
beach *
|
||
| İbadet Yerleri | ||
churchhindu_templemosquesynagogue
|
||
| Hizmetler | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * |
lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care
|
|
| Alışveriş | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store
|
home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler
|
|
| Spor | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * |
playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool
|
|
| Ulaşım | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station |
park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_stop
|
|
Tablo B
B tablosundaki 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
|
|
Adres türleri ve adres bileşeni türleri
Yanıtın types dizisi, adres türünü belirtir. Adres türlerine örnek olarak açık adres, ülke veya siyasi birim verilebilir. AddressComponent alanındaki types dizisi, adresin her bir bölümünün türünü belirtir. Örneğin, bina numarası veya ülke.
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 |
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şilik Genellikle bu tür, bir idari birimin 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ö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 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ölge. 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 tüzel kişiliği. |
sublocality |
Bir yerleşim biriminin altındaki birinci dereceden idari bölge. Bazı konumlar için sublocality_level_1 ile sublocality_level_5 arasındaki ek türlerden biri 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 bulunan, adreslenebilir bir öğe (ör. apartman, birim veya süit). |
plus_code |
Enlem ve boylamdan elde edilen, kodlanmış bir konum referansı. Plus code'lar, sokak adreslerinin olmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) sokak adreslerinin 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 |
Belirgin bir doğal alan. |
airport |
Havalimanı |
park |
Adlandırılmış bir park. |
point_of_interest |
Adlandırılmış bir önemli yer. Genellikle bu "önemli yerler", "Empire State Binası" veya "Eyfel Kulesi" gibi başka bir kategoriye kolayca uymayan, öne çıkan yerel varlıklardır. |
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 de içerebilir.
| Adres Bileşeni Türü | Açıklama |
|---|---|
floor |
Bina adresinin bulunduğu kat. |
establishment |
Genellikle henüz sınıflandırılmamış 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. |