Places API iki API sürümünü destekler: Places API mevcut API'lerdir. Places API (Yeni) ise API'lerin yeni nesil sürümüdür.
Places API'nin (Yeni) kullanıma sunulmasıyla birlikte ilk göreviniz, hangi API kümesinin kullanılacağına karar vermektir. Bu, yeni bir müşteriyseniz veya halihazırda API'leri kullanan mevcut bir müşteriyseniz geçerlidir. İki API arasındaki temel farkları anlamak için bu kılavuzu kullanın.
API listesi
Aşağıdaki tabloda her iki API grubu da listelenmiştir. Mevcut bir müşteriyseniz şu anda kullanmakta olduğunuz bir API'nin yerini alan yeni API'yi belirlemek için bu tablodan yararlanabilirsiniz.
| Places API | Places API (Yeni) | Not |
|---|---|---|
| Yer Bulma | Metin Arama (Yeni) | Yer Bulma uygulamasının yeni bir sürümü bulunmamaktadır. Yerini Metin Arama (Yeni) aldı. |
| Yakındakiler Arama | Yakındakilerde Arama (Yeni) | Yakındaki Arama (Yeni) metin girişini desteklemediğinden metin sorgusu içeren mevcut API'yi kullanan tüm istekler Metin Arama (Yeni) özelliğini kullanmalıdır. |
| Metin Arama | Metin Arama (Yeni) | |
| Yer Ayrıntıları | Yer Ayrıntıları (Yeni) | |
| Yer Fotoğrafı | Yer Fotoğrafı (Yeni) | |
| Otomatik Yer Tamamlama | Otomatik tamamlama (Yeni) | Önizlemede |
| Sorgu Otomatik Tamamlama | Otomatik tamamlama (Yeni) | Otomatik Tamamlama'nın Önizleme sürümüne eklenen özellikler (Yeni) |
API anahtarınızda etkinleştirdiğiniz Places API hizmetinin sürümü, uygulamanız tarafından kullanılan API'leri kontrol eder:
Places API: Mevcut API'leri etkinleştirir. Uygulamanız için kullanılan API anahtarıyla ilişkilendirilmiş proje için yalnızca Places API etkinse uygulamanız yeni API'lere erişemez.
Places API (Yeni): iOS için Yerler SDK'sına eklenen önemli özellikler (Yeni) bölümünde açıklanan tüm yeni API'leri ve özellikleri etkinleştirir. Uygulamanız mevcut API'lere erişemez.
Her ikisi de: Hem iOS için Yerler SDK'sı (Yeni) hem de iOS için Yerler SDK'sı için tüm özellikleri ve API'leri etkinleştirir.
Places API hizmetini seçme hakkında daha fazla bilgi için Google Cloud projenizi ayarlama bölümüne bakın.
Yeni API'lere geçin
Mevcut bir API kullanıyor ve yeni API'ye geçmek istiyorsanız her API için aşağıdaki taşıma rehberlerine bakın:
- Yakındaki Arama'ya geçiş (Yeni)
- Metin Arama'ya Geçiş (Yeni)
- Yer Ayrıntılarına Geçiş (Yeni)
- Yer Fotoğrafına Geçiş (Yeni)
- Otomatik Tamamlamaya Taşı (Yeni)
Places API'ye eklenen temel özellikler (Yeni)
Bu bölümde, Places API'ye (Yeni) eklenen temel özellikler ele alınmaktadır.
Google Cloud standart platformunda uygulandı
Places API (Yeni), Google Cloud'daki hizmet altyapısında uygulanır. Bu uygulama, OAuth gibi gelişmiş güvenlik seçenekleriyle daha güvenli ve güvenilir bir platform sunuyor. Bu standart API tasarımı, Places API (Yeni) ile geliştirmenin verimliliğini artıran API'ler arasında bir tutarlılık düzeyi sağlar.
Artırılmış performans
Places API (Yeni) iyileştirilmiş performans sunduğundan mevcut Places API'yi kullanan uygulamaların yerini alması faydalı olur.
Basitleştirilmiş fiyatlandırma
Places API (Yeni) ile fiyatlandırma basitleştirildi, böylece yalnızca kullandığınız veriler için ödeme yaparsınız. Basitleştirilmiş fiyatlandırma, alan maskesi kullanılarak uygulanır.
Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) ile yanıtta döndürülecek alanların listesini kontrol etmek için alan maskesini kullanırsınız. Böylece yalnızca istenen veriler için faturalandırılırsınız. Alan maskeleme kullanmak, gereksiz veri isteğinde bulunmadığınızdan emin olmak için iyi bir tasarım uygulamasıdır. Böylece gereksiz işleme süresi ve faturalandırma ücretlerinin önüne geçilir.
Bir yer için tutarlı yanıt verileri
Mevcut API'lerle, Yer Ayrıntıları, Yakında Arama ve Metin Arama API'leri bir yer için farklı yanıt verileri döndürdü. Places API (Yeni), yanıtı standartlaştırarak bu API'lerin bir yer için aynı verileri döndürmesini sağlar.
Genişletilmiş yer türleri
API yanıtı artık bir yerin birincil türünü içerebilir. Her yerin, Tablo A'da listelendiği gibi yerin birincil türü olarak belirtilen tek bir tür değeri olabilir.
Ayrıca yeni API, aşağıdaki tabloda gösterilen yer türlerini de ekler. Bu yeni türleri ve mevcut türleri, Yakındaki Arama (Yeni) ve Metin Arama (Yeni) özellikleriyle yaptığınız bir aramada kullanabilirsiniz. Yeni türlerin tümü A Tablosu'nda yer almaktadır.
| Tür | |||
|---|---|---|---|
| american_restaurant | discount_store | ice_cream_shop | sandwich_shop |
| amusement_center | dog_park | indian_restaurant | school_district |
| athletic_field | electric_vehicle_charging_station | indonesian_restaurant | seafood_restaurant |
| auto_parts_store | event_venue | italian_restaurant | ski_resort |
| banquet_hall | extended_stay_hotel | japanese_restaurant | spanish_restaurant |
| barbecue_restaurant | çiftlik | korean_restaurant | sporting_goods_store |
| barber_shop | Farmstay | lebanese_restaurant | sports_club |
| bed_and_breakfast | fast_food_restaurant | Marina | sports_complex |
| brazilian_restaurant | ferry_terminal | market | steak_house |
| breakfast_restaurant | fitness_center | medical_lab | sushi_restaurant |
| brunch_restaurant | french_restaurant | mediterranean_restaurant | swimming_pool |
| bus_stop | gift_shop | mexican_restaurant | terzi |
| camping_cabin | golf_course | middle_eastern_restaurant | telecommunications_service_provider |
| cell_phone_store | greek_restaurant | motel | thai_restaurant |
| child_care_agency | grocery_store | national_park | transit_depot |
| chinese_restaurant | guest_house | park_and_ride | truck_stop |
| coffee_shop | hair_salon | performing_arts_theater | turkish_restaurant |
| community_center | hamburger_restaurant | pizza_restaurant | vegan_restaurant |
| danışman | Heliport | playground | vegetarian_restaurant |
| convention_center | hiking_area | okul öncesi kurum | vietnamese_restaurant |
| kır evi | historical_landmark | private_guest_room | visitor_center |
| courier_service | home_improvement_store | ramen_restaurant | wedding_venue |
| cultural_center | pansiyon | resort_hotel | toptancı |
| dental_clinic | otel | rest_stop |
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
Dinamik yer verileri
Places API (Yeni), elektrikli araç şarj istasyonunun kullanılabilirliği veya bir benzin istasyonunun en güncel yakıt fiyatları gibi dinamik yanıt verilerini destekler. Dinamik kullanıcı deneyimleri oluşturmak için bu yanıt alanlarını kullanın.
Hangi API'yi seçersiniz?
Uygulama geliştirmeye başlamadan önce API'nizi seçmeniz gerekir:
Yeni bir müşteriyseniz Places API'yi yeni kullanmaya başlıyorsanız yeni API'lerle başlayın.
Yeni bir müşteriyseniz ve henüz Otomatik Yer Tamamlama veya Sorgu Otomatik Tamamlama gibi mevcut bir API'nin yerine geçmediyseniz yeni ve mevcut API'lerin bir kombinasyonunu kullanabilirsiniz.
Mevcut müşteriyseniz mevcut API'leri kullanmaya devam edebilirsiniz. Bununla birlikte, Places API'nin (Yeni) performans iyileştirmelerinden ve özellik geliştirmelerinden yararlanmak için yeni API'lere geçiş yapabilirsiniz.
Taşıma hakkında daha fazla bilgi için Taşımaya genel bakış sayfasına göz atın.