API sürümünüzü seçin

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)

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:

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
Bu yeni türlerle birlikte, Android için Yerler SDK'sı (Yeni) aşağıdaki türleri Tablo B'den Tablo A'dan taşımıştır. Yani artık arama kapsamında aşağıdaki türleri kullanabilirsiniz:
  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

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:

  1. Yeni bir müşteriyseniz Places API'yi yeni kullanmaya başlıyorsanız yeni API'lerle başlayın.

  2. 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.

  3. 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.