Places API yanıtını taşıma

Yeni Yer Ayrıntıları, Yakında Arama ve Metin Arama API'lerinin yanıt biçimi, mevcut API'lerin biçiminden farklıdır. En önemli fark ise aşağıda açıklandığı gibi her bir yöntem tarafından döndürülen Place nesnesinin biçimi Yanıt Yer nesnesinde yapılan değişiklikler.

Ayrıca, yanıt nesnesinin üst düzey alanları da her API için değişti. Bkz.:

Yanıttaki Yer nesnesindeki değişiklikler

Bu tabloda, yeni Place nesne Yer Ayrıntıları (Yeni) adlı kullanıcıya verilen yanıtta, Yakındaki Arama (Yeni) ve Mevcut ile karşılaştırıldığında Metin Arama (Yeni) Place nesne.

Yeni yanıt nesnesi, alan adları için büyük/küçük harf kullanımını kullanır, yeni alanlar içerir ve ve mevcut alanlardan bazılarını yeniden adlandırıyor.

Alan Mevcut Yer nesnesi Yeni yer nesnesi Notlar
Adres bileşeni address_components addressComponents
Yer mikro biçimi adresi adr_address adrFormatAddress
İşletmenin durumu business_status businessStatus
Gelecek hafta çalışma saatleri current_opening_hours currentOpeningHours
İçerik özeti editorial_summary editorialSummary
Biçimlendirilmiş adres formatted_address formattedAddress
Ulusal telefon numarası formatted_phone_number nationalPhoneNumber
Konum geometry.location location
Görüntü alanı geometry.viewport viewport
Yer atıfları html_attributions attributions Mevcut API'lerdeki yanıtın üst düzey alanı
Simge URL'si icon Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor özelliğini kullanın. Daha fazla bilgi için Simgeleri yerleştirme bölümüne bakın.
Simge arka plan rengi icon_background_color iconBackgroundColor
Simge maskesi URL'si icon_mask_base_uri iconMaskBaseUri
Uluslararası telefon numarası international_phone_number internationalPhoneNumber
Metin yer adı name displayName Metin yer adına artık displayName.text ve displayName.languageCode tekniğiyle language
Çalışma saatleri opening_hours regularOpeningHours
Fotoğraflar photos photos photos biçimi yeni Place nesne algılandı. Daha fazla bilgi için Fotoğraf referanslarına geçme başlıklı makaleyi inceleyin.
Yer kimliği place_id id
Plus code plus_code plusCode
Fiyat düzeyi price_level priceLevel
Derecelendirme rating rating
Yorumlar reviews reviews
Bugünden itibaren gelecek hafta için ikincil çalışma saatleri tüm diğer veriler secondary_opening_hours currentSecondaryOpeningHours
Yer türleri types types
Yerin Google Haritalar URL'si url googleMapsUri
Kullanıcı puanı sayısı user_ratings_total userRatingCount
UTC farkı utc_offset utcOffsetMinutes
Sokak adı ve ilçeyi içeren kısa adres biçimi vicinity shortFormattedAddress
Yerin web sitesi website websiteUri
Tekerlekli sandalyeyle erişilebilirlik bilgileri wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance şu an şu saatte: accessibilityOptions.wheelchairAccessibleEntrance
Yer özellikleri takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
Kaynak adı places/PLACE_ID formundaki name alanı Mevcut API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName
Yerin birincil türü primaryTypeName Yeni
Birincil türü metin dizesi olarak yerleştir primaryTypeDisplayName Yeni
İstisnalar ve diğer tüm dönemler dahil olmak üzere normal haftalık ikincil çalışma saatleri veri regularSecondaryOpeningHours Yeni
Yerin kabul ettiği ödeme seçenekleri paymentOptions Yeni
Park yeri seçenekleri parkingOptions Yeni
Yerle ilgili alt hedeflerin listesi subDestinations Yeni
Benzin istasyonundaki yakıt seçenekleriyle ilgili en son bilgiler fuelOptions Yeni
Bir yer için EV şarj bilgileri evChargeOptions Yeni
Yer özellikleri outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Yeni

Metin Arama yanıt değişiklikleri

Aşağıdaki tabloda, mevcut metin arama için yanıt nesnesinin üst düzey alanlarında ve metin arama (yeni) için yanıt nesnesinde yapılan değişiklikler gösterilmektedir. Yeni API için yanıttaki tek üst düzey alan places dizisidir.

Alan Metin Arama (Mevcut) Metin Arama (Yeni) Notlar
Yer atıfları html_attributions Her yer için place.attributions olarak yeni Place nesnesine taşındı
Yer dizisi results mevcut Place nesnesi dizisi Yeni Place nesnesinin places dizisi
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı
Hata mesajları error_message Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı
Tüm bilgi mesajları info_messages Kaldırıldı
Sayfa jetonu next_page_token Kaldırıldı

Yakında Arama yanıtı değişiklikleri

Aşağıdaki tabloda, yanıtın üst düzey alanlarında yapılan değişiklikler gösterilmiştir nesne mevcut Yakındaki Arama ve yanıtı için nesne (Yeni) seçeneğini tıklayın. Yeni API için yanıt, places dizisidir.

Alan Yakında Arama (Mevcut) Yakında Arama (Yeni) Notlar
Yer ilişkilendirmeleri html_attributions Yeni Yer'e taşındı her yer için place.attributions nesnesi
Bir dizi yer results mevcut Place nesnesi dizisi Yeninin places dizisi Yer nesnesi
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesaj) taşındı
Hata mesajları error_message Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı
Tüm bilgi mesajları info_messages Kaldırıldı
Sayfa jetonu next_page_token Kaldırıldı

Yer ayrıntıları yanıtı değişiklikleri

Aşağıdaki tabloda, mevcut Yer Ayrıntıları için yanıt nesnesinin üst düzey alanlarında ve Yer Ayrıntıları (Yeni) için yanıt nesnesinde yapılan değişiklikler gösterilmektedir. Yeni API için yanıt, places dizisidir.

Alan Yer Ayrıntıları (Mevcut) Yer Ayrıntıları (Yeni) Notlar
Yer ilişkilendirmeleri html_attributions Yeni Yer'e taşındı attributions olarak nesne
Yer ayrıntıları Mevcut Place nesnesini içeren result Yeni Yer nesnesi
İsteğin durumu status Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı
Tüm bilgi mesajları info_messages Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı