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ındaki 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_restaurant
veyasteak_house
olabilir.Bir yerin birincil türü desteklenen bir tür değilse birincil tür eksik olabilir. Birincil tür mevcut olduğunda her zamantypes
alanındaki türlerden biri olur. - Bir yerle ilişkili Tablo A türünden 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_address
olarak etiketlenebilir ve adresin bir bileşenistreet_number
olarak 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.
Bu türlere erişmek için Google Cloud projenizde Places API (New)'yi etkinleştirmeniz gerekir. Daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.
Tür tabloları hakkında
A Tablosu, aşağıdaki şekillerde kullanılan türleri listeler:
- Yer Ayrıntıları (Yeni),
Yakınlardaki Arama (Yeni) ve
Metin Arama (Yeni) yanıtının bir parçası olarak,
Tablo A'daki değerler
GMSPlace
örneğinin türler özelliğini doldurmak için kullanılır. İstek, alan listesindeGMSPlacePropertyTypes
değerini belirtmelidir. - Yakındaki Arama (Yeni) isteğinin bir parçası olarak, dahil edilen türler, hariç tutulan türler, dahil edilen birincil türler ve hariç tutulan birincil türler parametresinin değeri olarak kullanılır.
- Bir Metin Arama (Yeni) isteğinin parçası olarak, dahil edilen tür parametresinin değeri olarak kullanılır.
- Yer Adı Otomatik Tamamlama (Yeni) isteğinin bir parçası olarak, türler parametresinin değerleri olarak kullanın.
GMSAutocompletePlaceSuggestion
örneğinin türler özelliğini doldurmak için kullanılan bir Yer Adı Otomatik Tamamlama (Yeni) yanıtının parçası olarak.
B Tablosu, Yer Ayrıntıları (Yeni), Yakınlarda Arama (Yeni), Metin Arama (Yeni) ve Yer 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 listesinde GMSPlacePropertyTypes
değerini belirtmelidir. B Tablosu'ndaki değerler, bir istek kapsamında kullanılamaz. Yalnızca Place Autocomplete (New) isteği için tür 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_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
İşletme | ||
corporate_office *farm ranch * |
||
Kültür | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Eğitim | ||
library preschool primary_school
|
school secondary_school university
|
|
Eğlence ve Dinlence Merkezi | ||
adventure_sports_center *amphitheatre *amusement_center amusement_park aquarium banquet_hall barbecue_area *botanical_garden *bowling_alley casino childrens_camp *comedy_club *community_center concert_hall *convention_center cultural_center cycling_park *dance_hall *dog_park event_venue |
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
|
Tesisler | ||
public_bath *public_bathroom *stable *
|
||
Finans | ||
accounting atm bank
|
||
Yiyecek ve İçecek | ||
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 *
|
Coğrafi Alanlar | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Resmi Kurumlar | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (yalnızca Japonya)police post_office
|
|
Sağlık ve Zindelik | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Konut | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Konaklama | ||
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
|
|
Doğal Alanlar | ||
beach *
|
||
İbadet Yerleri | ||
church hindu_temple mosque synagogue
|
||
Hizmetler | ||
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
|
|
Alışveriş | ||
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
|
|
Spor | ||
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
|
|
Ulaşım | ||
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
|
Tablo B
Ek yer türü değerleri | ||
---|---|---|
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
|
Adres türleri ve adres bileşeni türleri
Yanıtın GMSPlace
sınıfındaki types
numaralandırması, adres türünü belirtir. Adres türlerine örnek olarak açık adres, ülke veya siyasi birim verilebilir. GMSAddressComponent
nesnesindeki types
dizisi, adresin her bir bölümünün türünü gösterir. Ö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şi. 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 sivil alan. ABD'de bu idari düzeyler eyaletlerdir. Bazı ülkelerde bu idari düzeyler bulunmaz. Ç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 düzey sivil idari birim. Amerika Birleşik Devletleri'nde bu idari düzeyler ilçelerdir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
administrative_area_level_3 |
Ülke düzeyinin altındaki üçüncü düzey sivil idari birim. Bu tür, küçük bir idari bölgeyi gösterir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
administrative_area_level_4 |
Ülke düzeyinin altında dördüncü düzey bir sivil varlık. Bu tür, küçük bir idari bölgeyi gösterir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
administrative_area_level_5 |
Ülke düzeyinin altında beşinci dereceden bir idari birim. Bu tür, küçük bir idari bölgeyi gösterir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
administrative_area_level_6 |
Ülke düzeyinin altında altıncı dereceden bir idari birim. Bu tür, küçük bir idari bölgeyi gösterir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
administrative_area_level_7 |
Ülke düzeyinin altındaki yedinci dereceden bir sivil varlık. Bu tür, küçük bir idari bölgeyi gösterir. Bazı ülkelerde bu idari düzeyler bulunmaz. |
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 sivil alan. Bazı konumlar için sublocality_level_1 ile sublocality_level_5 arasındaki ek türlerden biri kullanılabilir. 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 konum, genellikle ortak bir ada sahip bir bina veya binalar topluluğu. |
subpremise |
Tesis düzeyinin altında, adreslenebilir bir varlık (ö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. Bu "ÖY"ler genellikle "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 sokak numarası. |
bus_station , train_station ve transit_station |
Otobüs, tren veya toplu taşıma durağının konumu. |