Places API Kullanımı ve Faturalandırması

Place API (Yeni) ve Places API, kullandıkça öde fiyatlandırma modelini kullanır. Places API (Yeni) ve Places API istekleri, birden fazla SKU'dan herhangi birine çağrı oluşturur. Genel Google Kullanım Şartları'nın yanı sıra, Places API'ye özel kullanım sınırları vardır. Google Cloud Console'daki araçlarla maliyetlerinizi ve kullanımınızı yönetin.

Places API'nin faturalandırması

Places API (Yeni) ve Places API, kullandıkça öde bir fiyatlandırma modeli kullanır. Google Haritalar Platformu API'leri ve SDK'ları, SKU'ya göre faturalandırılır. Kullanım her SKU için izlenir ve herhangi bir API'nin veya SDK'nın birden fazla ürün SKU'su olabilir. Maliyet şu şekilde hesaplanır:

SKU kullanımı × Kullanım başına fiyat

API veya SDK başına kullanım maliyetinizi tahmin etmek için Fiyatlandırma ve Kullanım Hesaplayıcı'yı kullanın. Uygun Google Haritalar Platformu SKU'larında her faturalandırma hesabı için her ay 200 ABD doları değerinde Google Haritalar Platformu kredisi kullanılabilir. Bu kredi, uygun SKU'lara otomatik olarak uygulanır1.

Places API Fiyatlandırması (Yeni)

Alan maskeleri hakkında

Yer Ayrıntıları (Yeni), Yakındaki Arama (Yeni) ve Metin Arama (Yeni) için yanıtta döndürülecek alanların listesini belirtmek üzere API isteklerinde FieldMask üstbilgisini kullanın. Bu işlemin ardından isteğiniz için geçerli olan en yüksek SKU üzerinden faturalandırılırsınız. Yani hem (Temel) hem de (Gelişmiş) SKU'da alan seçerseniz (Gelişmiş) SKU'ya göre 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şlem süresinden ve fatura ücretlerinden kaçınmış olursunuz.

SKU: Yer Ayrıntıları (Yalnızca Kimlikler)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: id, name*, photos

* name alanı, yer kaynak adını şu biçimde içerir: places/PLACE_ID. Yerin metin adına erişmek için displayName öğesini kullanın.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)		 Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)		 Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)

SKU: Yer Ayrıntıları (Temel)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: accessibilityOptions, addressComponents, adrFormatAddress, businessStatus, displayName, formattedAddress, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, location, primaryType, primaryTypeDisplayName, plusCode, shortFormattedAddress, subDestinations, types, types, types utcOffsetMinutesviewport

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,0170 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yer Ayrıntıları (Gelişmiş)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,020 ABD doları(1.000 başına 20,00 ABD doları)		 Her bir
başına 0,016 ABD doları(1.000 başına 16,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yer Ayrıntıları (Tercih Edilen)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions* için 3 $ / 3, {2 } ABD doları /fuelOptionsgoodForChildrengoodForGroupsgoodForWatchingSportsliveMusicmenuForChildrenparkingOptionspaymentOptionsoutdoorSeatingreservablerestroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

Aynı API çağrısında kullanılan diğer tüm alanlar normal şekilde faturalandırılır. GKST öncesi ürünlere ve özelliklere verilen destek sınırlı olabilir. Ayrıca, GKST öncesi ürünler ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar kapsamındadır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,025 ABD doları(1.000 başına 25,00 ABD doları)		 Her bir
için 0,020 ABD doları(1.000 başına 20,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yakında Arama (Temel)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.id, places.location, places.name*, places.name* şeklinde {/2 /}{2, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress alanı, places.plusCode, places.primaryType, {1 }places.photosplaces.primaryTypeDisplayNameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

places/PLACE_ID Yerin metin adına erişmek için places.displayName öğesini kullanın.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Her bir
için 0,0256 ABD doları(1.000 başına 25,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yakında Arama (Gelişmiş)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,035 ABD doları(1.000 başına 35,00 ABD doları)		 Her bir
için 0,028 ABD doları(1.000 başına 28,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yakındaki Arama (Tercih Edilen)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions* için 3 $ / 3, {2 } ABD doları /places.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

Aynı API çağrısında kullanılan diğer tüm alanlar normal şekilde faturalandırılır. GKST öncesi ürünlere ve özelliklere verilen destek sınırlı olabilir. Ayrıca, GKST öncesi ürünler ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar kapsamındadır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,040 ABD doları(1.000 başına 40,00 ABD doları)		 Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Metin Arama (Yalnızca Kimlik)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.id, places.name*
* places.name alanında, şu formda yer kaynak adı yer alır: places/PLACE_ID.
Yerin metin adına erişmek için places.displayName öğesini kullanın.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)		 Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)		 Her bir
başına 0,0 ABD doları(1.000 başına 0,00 ABD doları)

SKU: Metin Arama (Temel)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.displayName, places.formattedAddress, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.shortFormattedAddress, places.subDestinations, places.subDestinations, places.subDestinations places.typesplaces.utcOffsetMinutesplaces.viewport

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Her bir
için 0,0256 ABD doları(1.000 başına 25,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Metin Arama (Gelişmiş)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,035 ABD doları(1.000 başına 35,00 ABD doları)		 Her bir
için 0,028 ABD doları(1.000 başına 28,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Metin Arama (Tercih Edilen)

Yer Ayrıntıları (Yeni) isteğinizde bir alan maskesi veya alan listesi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Bu SKU, yalnızca aşağıdaki alanları istediğinizde tetiklenir:

Web hizmeti: places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions* için 3 $ / 3, {2 } ABD doları /places.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

Aynı API çağrısında kullanılan diğer tüm alanlar normal şekilde faturalandırılır. GKST öncesi ürünlere ve özelliklere verilen destek sınırlı olabilir. Ayrıca, GKST öncesi ürünler ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar kapsamındadır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,040 ABD doları(1.000 başına 40,00 ABD doları)		 Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yer Fotoğrafı

Yer Fotoğrafı SKU'su, API'ye yapılan her istek için ücretlendirilir.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,007 ABD doları(1.000 başına 7,00 ABD doları)		 Her bir
için 0,0056 ABD doları(1.000 başına 5,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Places API fiyatlandırması

Otomatik tamamlama oturumları hakkında

Bir Otomatik Tamamlama oturumu, bazı Otomatik Tamamlama isteklerini (kullanıcı yazarken bir yerden öneriler almak için) ve en fazla bir Yer Ayrıntıları isteği (kullanıcı tarafından seçilen yerle ilgili ayrıntıları almak için) içerir. Aynı oturum jetonu, Otomatik Tamamlama ve sonraki Yer Ayrıntısı isteğine iletilir. Oturum, ilk Otomatik Tamamlama isteğiyle başlar (bu genellikle kullanıcı yazmaya başladığında gerçekleşir). Kullanıcı, Otomatik tamamlama önerilerinden birini seçtiğinde Yer Ayrıntıları çağrısı yapılır. Kullanıcı bir öneriyi seçmezse Yer Ayrıntıları çağrısı yapılmaz.

Bir kullanıcı bir yer seçtikten sonra (yani, Yer Ayrıntıları çağrısı yapıldıktan sonra), yeni bir oturum jetonu kullanarak yeni bir oturum başlatmanız gerekir.

Otomatik tamamlama oturumları aşağıdaki API'lerden oluşturulabilir:

Bir oturum jetonu, bir kullanıcı oturumu için uygundur ve birden fazla kullanıcı oturumu için kullanılmamalıdır. Bir oturum jetonunu yeniden kullanırsanız oturum geçersiz sayılır ve istekler için hiçbir oturum jetonu sağlanmamış gibi ücret alınır.

Oturumları kullanan Otomatik Tamamlama istekleri ve Yer Ayrıntıları istekleri farklı SKU'larda faturalandırılır.

Yer Verileri SKU'ları hakkında

Üç Yer Verileri SKU'su vardır: Temel Veriler, İletişim Verileri ve Atmosfer Verileri.

Şunlar için bir veya daha fazla Veri SKU'su tetiklenir:

  • Android: fetchPlace() veya findCurrentPlace() için yapılan her istek
  • iOS: fetchPlaceFromPlaceID: veya findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: için her çağrı
  • Web hizmeti: İstekte belirtilen alanlara bağlı olarak her Yer isteği

Veri SKU'ları, kendilerini tetikleyen istek için her zaman temel SKU'ya ek olarak ücretlendirilir. Örneğin, Temel Veri alanları içeren bir Yer Ayrıntısı isteği, hem Temel Veri SKU'su hem de Yer Ayrıntısı SKU'su altında ücretlendirilir.

Web hizmeti için bu Yerler API'leri çağrıları, döndürülecek veri alanlarının belirtilmesini destekler:

Web hizmeti için bu Places API çağrıları, döndürülen alanların belirtilmesini DESTEKLEMEZ. Bu çağrılar her zaman tüm Yerler verilerini döndürür ve her API isteğinin ücretine ek olarak üç Yer Verisi SKU'sundan ücret alır:

SKU: Temel Veriler

Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Temel kategorisindeki alanlar, Yerler isteğinin temel maliyetine dahil edilir ve herhangi bir ek ücretle sonuçlanmaz. Temel Veriler SKU'su, şu alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.ADDRESS, Place.Field.ADDRESS_COMPONENTS, Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.ID, Place.Field.LAT_LNG, Place.Field.NAME, Place.Field.PHOTO_METADATAS, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT, Place.Field.UTC_OFFSET veya Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • iOS: GMSPlaceFieldFormattedAddress, GMSPlaceFieldBusinesssStatus, GMSPlaceFieldID, GMSPlaceFieldCoordinate, GMSPlaceFieldName, GMSPlaceFieldPhotos, GMSPlaceFieldPlusCode,GMSPlaceFieldTypes veya GMSPlaceFieldViewport
  • Web hizmeti: address_component, adr_address, business_status, formatted_address, geometry, icon, name, permanently_closed, photo, place_id, plus_code, type, url, utc_offset, vicinity veya wheelchair_accessible_entrance
AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ 0,00 TRY		 Yer isteği maliyeti
+ 0,00 TRY		 Yer isteği maliyeti
+ 0,00 TRY

SKU: İletişim Verileri

Web hizmetleri için Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini ya da Android veya iOS için bir Place.Field dizisi kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Kişi kategorisindeki alanlar ek ücrete tabidir. İletişim Verileri SKU'su, şu alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.SECONDARY_OPENING_HOURS veya Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber veya GMSPlaceFieldWebsite
  • Web hizmeti: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours veya website
AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ her biri için 0,003 ABD doları
(+ 1.000 başına 3 ABD doları)		 Yer isteği maliyeti
+ her biri için 0,0024 ABD doları
(+ 1.000 başına 2,40 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Atmosfer Verileri

Yer Ayrıntıları veya Yer Bulma isteğinizdeki alanlar parametresini kullanarak yanıtı yalnızca belirtilen alanlarla sınırlandırabilirsiniz. Atmosfer kategorisindeki alanlar ek ücrete tabidir. Atmosfer Verileri SKU'su, aşağıdaki alanlardan herhangi biri istendiğinde tetiklenir:

  • Android: Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.EDITORIAL_SUMMARY, Place.Field.DINE_IN, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.RESERVABLE, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT veya Place.Field.USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel, GMSPlaceFieldRating, GMSPlaceFieldUserRatingsTotal, GMSPlaceFieldTakeout, GMSPlaceFieldDelivery, GMSPlaceFieldDineIn, GMSPlaceFieldCurbsidePickup, GMSPlaceFieldReservable,GMSPlaceFieldServesBreakfast, GMSPlaceFieldServesLunch, GMSPlaceFieldServesDinner, GMSPlaceFieldServesBeer, GMSPlaceFieldServesWine, GMSPlaceFieldServesBrunch veya GMSPlaceFieldServesVegetarianFood.
  • JavaScript: Alanlar (Yer ayrıntıları) konusuna bakın
  • Web hizmeti: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout veya user_ratings_total.
AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Yer isteği maliyeti
+ her biri için 0,005 ABD doları
(+ 1.000 başına 5 ABD doları)		 Yer isteği maliyeti
+ her biri için 0,004 ABD doları
(+ 1.000 başına 4,00 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Otomatik Tamamlama - İstek Başına

Otomatik Tamamlama - İstek Başına SKU'su, oturum jetonu içermeyen şu çağrı veya istekler için ücretlendirilir:

Geçersiz bir Otomatik Tamamlama oturumundan (örneğin, bir oturum jetonunu yeniden kullanan bir oturum) yapılan aramalardan da Otomatik Tamamlama - İstek Başına SKU'su için ücret alınır.

Haritalar JavaScript API'sinin Otomatik Tamamlama Widget'ından gelen Otomatik Tamamlama isteklerinden, geçersiz bir Otomatik Tamamlama oturumundan çağrı yapılması durumunda Otomatik Tamamlama – İstek Başına SKU'su alınabilir. Bu durum, bir kullanıcı birden çok farklı adres yazarken veya farklı adresleri kopyalayıp widget'a yapıştırdığında ve her zaman bir otomatik tamamlama tahmini seçmediğinde ortaya çıkabilir.

AYLIK SAYI ARALIĞI
(İSTEK başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,00283 ABD doları(1.000 başına 2,83 ABD doları)		 Her bir
için 0,00227 ABD doları(1.000 başına 2,27 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

SKU: Yer Ayrıntıları olmadan Otomatik Tamamlama - Oturum Başına

Yer Ayrıntıları olmadan Otomatik Tamamlama SKU'su, Yer Ayrıntısı isteği içermeyen (oturumun başlangıcından birkaç dakika önce) Otomatik Tamamlama oturumu için ücretlendirilir.

AYLIK SAYI ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Örnek

Uygulamanız tek bir oturumda şu iki çağrıyı yaparsa:

Android

iOS

Web hizmeti

Faturanızda bu SKU'nun listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer Ayrıntıları olmadan Otomatik Tamamlama - Oturum Başına (oturum başına 0,017 ABD dolarından başlayan fiyatlar)

SKU: Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına

Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına SKU'su, aşağıdakilerden herhangi birini içeren bir Otomatik Tamamlama oturumu için ücretlendirilir:

  • Android: fetchPlace() çağrısı
  • iOS: fetchPlaceFromPlaceID: çağrısı
  • Web hizmeti: Yer Ayrıntısı isteği

Otomatik tamamlama isteği ücretsizdir ve sonraki Yer Ayrıntısı araması için normal Yer Ayrıntıları fiyatlandırmasına göre ücret alınır.

Yer Ayrıntısı isteği, istekte belirtilen alanlara bağlı olarak Veri SKU'ları (Temel, Kişi ve/veya Atmosfer) oluşturur.

Yer Ayrıntıları isteğinde alan belirtmezseniz tüm Veri SKU'ları tetiklenir (Temel, Kişi ve Atmosfer).

Otomatik tamamlama oturumu sırasında Yer Ayrıntıları Kimliği yenileme istekleri (yalnızca place_id alanını belirten istekler) SKU: Yer Ayrıntıları olmadan Otomatik Tamamlama - Oturum Başına olarak faturalandırılır.

AYLIK SAYI ARALIĞI
(OTURUM başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
0.00 TRY 0.00 TRY 0.00 TRY

Örnek

Uygulamanız tek bir oturumda aşağıdaki üç çağrıyı yaparsa:

Android

iOS

Web hizmeti

Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Otomatik Tamamlama (Yer Ayrıntıları dahil) - Oturum Başına (0,00 ABD doları üzerinden faturalandırılır)
  • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
  • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)

SKU: Otomatik Sorgu Tamamlama - İstek Başına

Sorgu Otomatik Tamamlama - İstek Başına SKU'su aşağıdakilerden hangisi için her istek için ücretlendirilir?

AYLIK SAYI ARALIĞI
(İSTEK başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,00283 ABD doları(1.000 başına 2,83 ABD doları)		 Her bir
için 0,00227 ABD doları(1.000 başına 2,27 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Otomatik Tamamlama oturumuyla fiyatlandırma, Sorgu Otomatik Tamamlama kullanıldığında desteklenmez. Sonraki Yer Ayrıntıları çağrıları, normal Yer Ayrıntıları fiyatlandırmasına göre ücretlendirilir.

SKU: Yer Ayrıntıları

Yer Ayrıntısı aramaları şu şekilde ücretlendirilir:

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Yer Ayrıntıları SKU'su şu API'lerden oluşturulur:

Web API ve hizmetlerde, oturum jetonu sağlanıp sağlanmadığına bakılmaksızın Yer Ayrıntıları SKU'su ücretlendirilir.

Yer Ayrıntıları çağrısı veya isteği, çağrıda ya da istekte belirtilen alanlara bağlı olarak Veri SKU'ları da (Temel, Kişi ve/veya Atmosfer) oluşturur. Yer Ayrıntıları çağrısında veya isteğinde HAYIR alanları belirtilirse TÜM Veri SKU'ları tetiklenir ve Yer Ayrıntıları çağrısı veya isteği ile tüm verilerin maliyeti için ücretlendirilirsiniz.

Örnekler

  1. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() uygulamasını veya iOS'ta fetchPlaceFromPlaceID: uygulamasını çağırın ve yalnızca ADDRESS alanını belirtin
    • Web API veya hizmet: Yer Ayrıntıları isteğinde bulunun ve yalnızca adres alanını belirtin: getPlaceDetails(fields: formatted_address)
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  2. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() uygulamasını veya iOS'ta fetchPlaceFromPlaceID: uygulamasını çağırın ve yalnızca PHONE_NUMBER alanını belirtin
    • Web API veya hizmet: Yer Ayrıntıları isteğinde bulunun ve telefon numarası alanını belirtin: getPlaceDetails(fields: formatted_phone_number)
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  3. Aşağıdaki çağrılardan veya isteklerden birini yapın:
    • Mobil: Android'de fetchPlace() yöntemini veya iOS'te fetchPlaceFromPlaceID: uygulamasını çağırın ve tüm alanları belirtin
    • Web API veya hizmet: Bir Yer Ayrıntısı isteği yapın ve tüm alanları belirtin (herhangi bir alan belirtmezseniz bu istek türü varsayılandır): getPlaceDetails().
    Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):
    • Yer Ayrıntıları (oturum başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Yer Ayrıntıları – Kimlik Yenileme

Eski yer kimliklerini yenilemek için Yer Ayrıntıları isteğini kullanın. Bu tür istekler ücretsizdir.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
0.00 TRY 0.00 TRY 0.00 TRY

Örnek

Yalnızca yer kimliği alanını belirterek bir Yer Ayrıntıları isteği yapın: getPlaceDetails(fields: place_id). Faturanızda bu SKU'nun listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer Ayrıntıları – Kimlik Yenileme (0,00 ABD Doları üzerinden faturalandırılır)

SKU: Yer Bulma

Yer Bulma isteği için Yer Bulma ücreti alınır.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
başına 0,017 ABD doları(1.000 başına 17,00 ABD doları)		 Her bir
için 0,0136 ABD doları(1.000 başına 13,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Yer Bulma istekleri, istekte belirtilen alanlara bağlı olarak Veri SKU'ları da (Temel, Kişi ve/veya Atmosfer) oluşturur. Yer Ayrıntıları isteklerinde olduğu gibi, yanıtı yalnızca belirtilen alanlarla sınırlamak için Yer Bulma isteğinizdeki alanlar parametresini kullanabilirsiniz. Yer Bulma isteği ve istenen veriler için faturalandırılırsınız. Varsayılan olarak, NO alanları istenirse yalnızca yer kimliği döndürülür. Böylece ek veri ücreti alınmaz.

Örnekler

  1. Yer Bulma isteği gönderirsiniz ve yalnızca adres alanını belirtirsiniz: FindPlace(fields: formatted_address). Faturanızda şu SKU'ların listelendiğini görürsünüz ( faturanızı SKU'ya göre görüntülerken):
    • Yer Bulma (arama başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  2. Yer Bulma isteği gönderirsiniz ve telefon numarası alanını belirtirsiniz: FindPlace(fields: formatted_phone_number). Faturanızda şu SKU'ların listelendiğini görürsünüz ( faturanızı SKU'ya göre görüntülerken):
    • Yer Bulma (arama başına 0,017 TRY'den başlayan fiyat)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  3. Yer Bulma isteği gönderirsiniz ve üç veri türü paketinin tamamından alanlar belirtirsiniz: FindPlace(fields: formatted_address, opening_hours, price_level). Faturanızda şu SKU'ların listelendiğini görürsünüz ( faturanızı SKU'ya göre görüntülerken):
    • Yer Bulma (arama başına 0,017 TRY'den başlayan fiyat)
    • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
    • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
    • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Yer Bulma – Yalnızca Kimlik

Yer Bulma - Yalnızca kimlik, yalnızca döndürülecek Yer Kimliği'ni belirten Yer Bulma istekleri için ücretlendirilir. Varsayılan olarak, Yer Bulma isteğinde herhangi bir alan belirtilmezse yalnızca yer kimliği döndürülür.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
0.00 TRY 0.00 TRY 0.00 TRY

Örnek

Yer Bulma isteği gönderiyorsunuz ve yalnızca place_id alanını belirliyorsunuz: FindPlace(fields: place_id). Faturanızda bu SKU'nun listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer Bulma - Yalnızca kimlik (0,00 ABD Doları üzerinden faturalandırılır)

Yer - Yakında Arama, Haritalar JavaScript API'nin Yakındaki Yerler Arama hizmetine (nearbySearch()) veya Places API Yakındaki Arama hizmetine yapılan istekler için ücretlendirilir

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Her bir
için 0,0256 ABD doları(1.000 başına 25,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Yakındaki Arama istekleri yer listesi döndürür, ancak hangi alanların döndürüleceğini belirtmeyi desteklemez. Yakındaki Arama istekleri, desteklenen veri alanlarının bir alt kümesini döndürür. Yakındaki Arama isteğinin yanı sıra tüm veri türü SKU'ları (Temel Veriler, İletişim Verileri ve Atmosfer Verileri) başına 0,032 ABD dolarından başlayan fiyatlarla ücretlendirilirsiniz.

Örnek

NearbySearch (San Francisco, 100 meters) gibi bir Yakındaki Arama isteğinde bulunursunuz. Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer - Yakında Arama (çağrı başına 0,032 ABD dolarından başlayan fiyat)
  • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Yer – Metin Arama

Yer - Metin Arama, Haritalar JavaScript API'nin Yer Metni Arama hizmetine (textSearch()) veya Places API'nin Metin Arama hizmetine yapılan istekler için ücretlendirilir.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,032 ABD doları(1.000 başına 32,00 ABD doları)		 Her bir
için 0,0256 ABD doları(1.000 başına 25,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Metin Arama istekleri bir yer listesi döndürür, ancak hangi alanların döndürüleceğini belirtmeyi desteklemez. Metin Arama istekleri, desteklenen veri alanlarının bir alt kümesini döndürür. Metin Arama isteğinin yanı sıra tüm veri türü SKU'ları (Temel Veriler, İletişim Verileri ve Atmosfer Verileri) başına 0,032 ABD dolarından başlayan fiyatlarla ücretlendirilirsiniz.

Yer - Metin Arama SKU'su, aşağıda gösterildiği gibi Haritalar JavaScript API'nin Yer Arama Kutusu widget'ı tarafından da oluşturulur: kullanıcı bir yer sorgusu (simge: büyüteç) seçtikten sonra getPlaces() yöntemi bir sonuç (simge: pin) değil:

Yer Ayrıntıları Arama Kutusu Widget Sorgu Seçimi
Arama kutusu widget'ının sonuçlarında, arama kutusuna "pizza" yazdıktan sonra pizza teslimatı seçeneğinin yanında, bunun bir yer sorgusu (bir sonuç değil) olduğunu belirten bir büyüteç simgesi olduğuna dikkat edin.

Örnek

TextSearch(123 Main Street) gibi bir Metin Arama isteğinde bulunursunuz. Faturanızda şu SKU'ların listelendiğini görürsünüz (faturanızı SKU'ya göre görüntülerken):

  • Yer - Metin Arama (arama başına 0,032 ABD dolarından başlayan fiyat)
  • Temel Veriler (0,00 ABD doları üzerinden faturalandırılır)
  • İletişim Verileri (istek başına 0,003 ABD dolarından başlayan fiyat)
  • Atmosfer Verileri (istek başına 0,005 ABD dolarından başlayan fiyat)

SKU: Yer Fotoğrafı

Yer Fotoğrafı SKU'su şunlar için ücretlendirilir:

JavaScript hizmetinde PlacePhoto.getUrl() yönteminin çağrılması, piksel verilerini almak için URL gerçekten kullanılana kadar faturalandırmaya neden olmaz.

AYLIK HEDEF ARALIĞI
(TELEFON ARAMASI başına fiyat)
0-100.000 100.001–500.000 500.000'den fazla
Her bir
için 0,007 ABD doları(1.000 başına 7,00 ABD doları)		 Her bir
için 0,0056 ABD doları(1.000 başına 5,60 ABD doları)		 Hacimli fiyatlandırma için Satış Ekibiyle İletişime Geçin

Diğer kullanım sınırları

Günlük istek sayısı üst sınırı olmasa da aşağıdaki kullanım sınırları geçerliliğini korur:

  • Places API (Yeni): Hız sınırı, proje başına API yöntemi başına 600 QPM'dir (dakika başına istek). Yani her API yönteminin ayrı bir kotası vardır.

  • Places API: Oran sınırı 6.000 QPM'dir (dakika başına istek). Aynı projenin kimlik bilgilerini kullanan tüm uygulamalar için istemci taraflı ve sunucu tarafı isteklerin toplamı olarak hesaplanır.

Kullanım Şartları kısıtlamaları

Kullanım şartları hakkında bilgi edinmek için Place API'ye yönelik politikalara ve Google Haritalar Platformu Hizmet Şartları'nın Lisans Kısıtlamaları bölümüne bakın.

Kullanım maliyetinizi yönetin

Places API kullanım maliyetinizi yönetmek veya üretim trafiğinizin taleplerini karşılamak için herhangi bir API'ye yapılan tüm isteklerde günlük kota sınırları belirleyin. Günlük kotalar Pasifik saatine göre gece yarısında sıfırlanır.

Places API'nin kota sınırlarını görüntülemek veya değiştirmek için:

  1. Cloud Console'da Google Haritalar Platformu Kotaları sayfasını açın.
  2. API'ler açılır menüsünü tıklayın ve Places API'yi seçin.
  3. Kota sınırlarını görüntülemek için İstekler kartına gidin.
    Bir tabloda kota adları ve sınırları listelenir.
  4. Bir kota sınırını değiştirmek için, söz konusu sınırın Düzenle simgesini tıklayın.
    Açılan iletişim kutusundaki Kota Sınırı alanına, tercih ettiğiniz faturalandırılabilir günlük kota sınırını (Google tarafından belirtilen kota sınırına kadar) girin ve Kaydet'i seçin.

API kullanımınız herhangi bir günde faturalandırılabilir kota sınırınıza ulaşırsa uygulamanız günün geri kalanında API'ye erişemez.

  1. Hindistan'daki kullanıcıların Maps Platform kredisini almak için Google Haritalar Platformu faturalandırma hesabı oluşturmadan önce Google Cloud Platform faturalandırma hesabı oluşturmaları gerekir. ↩