Bu ürün eski durumdadır. Ekim 2026'dan itibaren Places API (Eski) yeni Google Cloud projeleri için etkinleştirilemeyecek. Mevcut projeler tam olarak desteklenmeye devam eder. Yeni özellikler ve daha iyi performans için Places API (Yeni) sürümüne geçin.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Yer Ayrıntıları (eski)

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Not: Sunucu tarafı ve istemci tarafı kitaplıkları

Places API, Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi ile de kullanılabilir. Places API ve istemci kitaplıkları, sunucu uygulamalarında kullanılmak üzere tasarlanmıştır.

İstemci taraflı uygulama geliştiriyorsanız Yerler SDK'sı for Android (Yeni), Yerler SDK'sı for iOS (Yeni) ve Yer Kitaplığı, Maps JavaScript API'ye göz atın.

Yer arama sonucunda place_id elde ettikten sonra, Yer Ayrıntıları (Eski) isteği başlatarak belirli bir işletme veya önemli yer hakkında daha fazla ayrıntı isteyebilirsiniz. Yer Ayrıntıları (Eski) isteği, belirtilen yer hakkında tam adresi, telefon numarası, kullanıcı puanı ve yorumları gibi daha kapsamlı bilgiler döndürür.

Yer Ayrıntıları (Eski) istekleri

Yer Ayrıntıları (Eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/details/output?parameters

Burada output, aşağıdaki değerlerden biri olabilir:

json (önerilen), JavaScript Object Notation (JSON) biçiminde çıkış yapılacağını belirtir.
xml, çıkışın XML biçiminde olduğunu gösterir.

Arama isteği başlatmak için belirli parametreler gereklidir. URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır. Aşağıdaki bölümlerde parametreler ve olası değerleri listelenmiştir.

Gerekli parametreler

place_id

Yer Arama (Eski) tarafından döndürülen ve bir yeri benzersiz şekilde tanımlayan metin tanımlayıcı. Yer kimlikleri hakkında daha fazla bilgi için yer kimliğine genel bakış bölümünü inceleyin.

İsteğe bağlı parametreler

Fields

Dikkat: Yer Arama (Eski) istekleri ve Yer Ayrıntıları (Eski) istekleri aynı alanları döndürmez. Yer Arama (Eski) istekleri, Yer Ayrıntıları (Eski) istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama (Eski) tarafından döndürülmüyorsa Yer Arama (Eski) kullanarak bir place_id alabilir, ardından bu yer kimliğini kullanarak Yer Ayrıntıları (Eski) isteği gönderebilirsiniz. Yer Arama (Eski) isteğinde kullanılamayan alanlar hakkında daha fazla bilgi için Yer Veri Alanları (Eski) bölümüne bakın.

Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtmek için fields parametresini kullanın. Örneğin: fields=formatted_address,name,geometry. Bileşik değerleri belirtirken eğik çizgi kullanın. Örneğin: opening_hours/open_now.

Alanlar üç faturalandırma kategorisine ayrılır: Temel, İletişim ve Atmosfer. Temel, İletişim ve Atmosfer SKU'ları, bunları tetikleyen istek için temel SKU'ya (Yer Ayrıntıları, Yer Bul, Yakında Arama veya Metin Arama) ek olarak ücretlendirilir. Daha fazla bilgi için fiyatlandırma sayfasına bakın.

Temel

Temel kategorisi şu alanları içerir: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (desteği sonlandırıldı), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

İletişim

İletişim kategorisi şu alanları içerir: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

Atmosfer

Atmosfer kategorisi şu alanları içerir: 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, user_ratings_total.

Not: Atıflar (html_attributions), alanın istenip istenmediğine bakılmaksızın her çağrıda her zaman döndürülür.
language

Sonuçların döndürüleceği dil.
- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste kapsamlı olmayabilir.
- language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
- API, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için açık adresleri yerel dilde döndürür ve gerekirse tercih edilen dili dikkate alarak kullanıcı tarafından okunabilir bir alfabeye dönüştürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen dilde döndürülür.
- Tercih edilen dilde bir ad yoksa API en yakın eşleşmeyi kullanır.
- Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlı kelimeler buna dahildir. Örneğin, Macarcada utca ve tér kelimeleri "sokak" anlamına gelir.
bölge

İki karakterli bir ccTLD ("üst düzey alan") değeri olarak belirtilen bölge kodu. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).
reviews_no_translations

Yorumların çevirisini devre dışı bırakmak için reviews_no_translations=true, etkinleştirmek için reviews_no_translations=false değerini belirtin. Yorumlar orijinal dillerinde döndürülür.

Atlanırsa veya değer olmadan iletilirse yorumların çevirisi etkinleştirilir. İstekte language parametresi belirtildiyse çeviri için tercih edilen dil olarak belirtilen dili kullanın. language atlanırsa API, tercih edilen dil olarak Accept-Language başlığını kullanmaya çalışır.
reviews_sort

Yorumlar döndürülürken kullanılacak sıralama yöntemi. most_relevant (varsayılan) veya newest olarak ayarlanabilir.
- most_relevant (varsayılan) için yorumlar alaka düzeyine göre sıralanır. Hizmet, sonuçları tercih edilen dilde yazılmış yorumları döndürecek şekilde ayarlar.
- newest için yorumlar kronolojik sıraya göre sıralanır. Tercih edilen dil, sıralama ölçütünü etkilemez.
Google, yorumların nasıl sıralandığını son kullanıcıya göstermenizi önerir.
sessiontoken

Faturalandırma amacıyla otomatik tamamlama oturumunu tanımlayan rastgele bir dize.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve bir yer seçip Yer Ayrıntıları (Eski) çağrısı yapıldığında sona erer. Her oturumda birden fazla sorgu ve ardından bir yer seçimi olabilir. Bir oturumdaki her istek için kullanılan API anahtarları aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdikten sonra jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessiontoken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri uygulamanızı öneririz:
- Tüm otomatik tamamlama oturumları için oturum jetonları kullanın.
- Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanılması önerilir.
- Bir oturumdaki tüm Yer Adı Otomatik Tamamlama ve Yer Ayrıntıları istekleri için kullanılan API anahtarlarının aynı Cloud Console projesine ait olduğundan emin olun.
- Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturum için kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

Uyarı: Bir istekte en az bir alan belirtmezseniz veya bir istekten fields parametresini çıkarırsanız olası TÜM alanlar döndürülür ve buna göre faturalandırılırsınız. Bu, yalnızca Yer Ayrıntıları (Eski) istekleri için geçerlidir.

Yer Ayrıntıları (Eski) örneği

Aşağıdaki örnekte, place_id ile bir yerin ayrıntıları istenmekte ve name, rating ve formatted_phone_number alanları yer almaktadır:

kabuk

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

İsteğin uygulamanızda çalışması için bu örnekteki anahtarı kendi API anahtarınızla değiştirin.

Yer Ayrıntıları (Eski) yanıtı

Yer Ayrıntıları (Eski) yanıtları, isteğin URL yolundaki output işaretiyle belirtilen biçimde döndürülür.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <!-- ... -->
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

JSON ve XML yanıtlarının her biri aşağıdaki öğeleri içerir:

PlacesDetailsResponse

Alan	Zorunlu	Tür	Açıklama
`html_attributions`	required	Dizi<string>	Bu girişle ilgili, kullanıcıya gösterilmesi gereken bir dizi ilişkilendirme içerebilir (bazı girişlerde ilişkilendirme olmayabilir).
`result`	required	Place	İstenen yerle ilgili ayrıntılı bilgileri içerir. Daha fazla bilgi için Place sayfasına bakın.
`status`	required	PlacesDetailsStatus	İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgilerini içerebilir. Daha fazla bilgi için PlacesDetailsStatus sayfasına bakın.
`info_messages`	isteğe bağlı	Dizi<string>	Hizmet, istek spesifikasyonu hakkında ek bilgi döndürdüğünde yanıt nesnesinde ek bir `info_messages` alanı olabilir. Bu alan yalnızca başarılı istekler için döndürülür. Her zaman döndürülmeyebilir ve içeriği değişebilir.

JSON yanıtında bunlar kök öğeler olarak temsil edilir. XML yanıtında bunlar, <PlaceDetailsResponse> altındaki üst düzey öğeler olarak görünür.

PlacesDetailsStatus

Hizmet tarafından döndürülen durum kodları.

API isteğinin başarılı olduğunu gösteren OK.
ZERO_RESULTS, referans verilen konumun (place_id) geçerli olduğunu ancak artık geçerli bir sonuca referans vermediğini gösterir. Bu durum, işletme artık faaliyet göstermiyorsa ortaya çıkabilir.
Referans verilen konumun (place_id) Yerler veritabanında bulunmadığını belirten NOT_FOUND.
INVALID_REQUEST, API isteğinin yanlış biçimlendirildiğini gösterir.
OVER_QUERY_LIMIT Aşağıdakilerden herhangi birini belirten:
- QPS sınırlarını aştınız.
- Hesabınızda faturalandırma etkinleştirilmemiştir.
- Aylık 200 ABD doları tutarındaki kredi veya kendi belirlediğiniz kullanım sınırı aşılmıştır.
- Sağlanan ödeme yöntemi artık geçerli değilse (ör. kredi kartının süresi dolmuşsa)
Bu hatanın nasıl çözüleceği hakkında daha fazla bilgi için Haritalar SSS sayfasını inceleyin.
REQUEST_DENIED genellikle şu nedenlerle isteğinizin reddedildiğini belirtir:
- İstekte API anahtarı eksik.
- key parametresi geçersiz.
Bilinmeyen bir hatayı gösteren UNKNOWN_ERROR.

Yer

Bir yeri tanımlayan özellikler. Tüm özellikler her yer türü için kullanılamayabilir.

Alan	Zorunlu	Tür	Açıklama
`address_components`	isteğe bağlı	Dizi<`AddressComponent`>	Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi. Daha fazla bilgi için `AddressComponent` sayfasına göz atın.
`adr_address`	isteğe bağlı	dize	Yerin adresinin adr mikro biçiminde gösterimi.
`business_status`	isteğe bağlı	dize	İşletme ise yerin faaliyet durumunu gösterir. Veri yoksa `business_status` döndürülmez. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	isteğe bağlı	boole	İşletmenin arabaya teslim alma hizmeti sunup sunmadığını belirtir.
`current_opening_hours`	isteğe bağlı	PlaceOpeningHours	Önümüzdeki yedi günün (bugün dahil) çalışma saatlerini içerir. Süre, isteğin gönderildiği gün gece yarısı başlar ve altı gün sonra 23:59'da sona erer. Bu alan, istisnai çalışma saatleri olan tarihler için ayarlanan tüm saatlerin `special_days` alt alanını içerir. Daha fazla bilgi için PlaceOpeningHours sayfasına bakın.
`delivery`	isteğe bağlı	boole	İşletmenin teslimat hizmeti sunup sunmadığını belirtir.
`dine_in`	isteğe bağlı	boole	İşletmenin kapalı veya açık oturma alanı seçeneklerini destekleyip desteklemediğini belirtir.
`editorial_summary`	isteğe bağlı	PlaceEditorialSummary	Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve varsa bunun dil kodunu da içerir. Özet metni olduğu gibi sunulmalıdır ve değiştirilemez. Daha fazla bilgi için PlaceEditorialSummary bölümüne bakın.
`formatted_address`	isteğe bağlı	dize	Bu yerin okunabilir adresini içeren bir dize. Bu adres genellikle posta adresiyle aynıdır. Birleşik Krallık gibi bazı ülkelerde, lisans kısıtlamaları nedeniyle gerçek posta adreslerinin dağıtımına izin verilmediğini unutmayın. Biçimlendirilmiş adres, mantıksal olarak bir veya daha fazla adres bileşeninden oluşur. Örneğin, "111 8th Avenue, New York, NY" adresi şu bileşenlerden oluşur: "111" (sokak numarası), "8th Avenue" (rota), "New York" (şehir) ve "NY" (ABD eyaleti). Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. Bunun yerine, API yanıtının biçimlendirilmiş adres alanına ek olarak içerdiği bağımsız adres bileşenlerini kullanmanız gerekir.
`formatted_phone_number`	isteğe bağlı	dize	Yerin telefon numarasını yerel biçiminde içerir.
`geometry`	isteğe bağlı	`Geometry`	Konumu ve konumun görüntü alanını içerir. Daha fazla bilgi için `Geometry` sayfasına göz atın.
`icon`	isteğe bağlı	dize	Bu sonuç bir haritada gösterilirken kullanıcıya gösterilebilecek önerilen bir simgenin URL'sini içerir.
`icon_background_color`	isteğe bağlı	dize	Yerin kategorisi için varsayılan onaltılık renk kodunu içerir.
`icon_mask_base_uri`	isteğe bağlı	dize	Önerilen bir simgenin URL'sini içerir (`.svg` veya `.png` dosya türü uzantısı hariç).
`international_phone_number`	isteğe bağlı	dize	Yerin telefon numarasını uluslararası standartta içerir. Uluslararası standart, ülke kodunu içerir ve artı (+) işaretiyle başlar. Örneğin, Google'ın Sidney, Avustralya ofisinin international_phone_number değeri `+61 2 9374 4000` şeklindedir.
`name`	isteğe bağlı	dize	Döndürülen sonucun kullanıcı tarafından okunabilen adını içerir. `establishment` sonuçları için bu genellikle standartlaştırılmış işletme adıdır.
`opening_hours`	isteğe bağlı	PlaceOpeningHours	Normal çalışma saatlerini içerir. Daha fazla bilgi için PlaceOpeningHours sayfasına bakın.
`permanently_closed`	isteğe bağlı	boole	`permanently_closed` desteği sonlandırıldı. İşletmelerin faaliyet durumunu öğrenmek için `business_status` kullanın.
`photos`	isteğe bağlı	Dizi<PlacePhoto>	Her biri bir resme referans veren fotoğraf nesneleri dizisi. Bir istek en fazla on fotoğraf döndürebilir. Yer fotoğrafları ve resimleri uygulamanızda nasıl kullanabileceğiniz hakkında daha fazla bilgiyi Yer Fotoğrafları belgelerinde bulabilirsiniz. Daha fazla bilgi için PlacePhoto sayfasına bakın.
`place_id`	isteğe bağlı	dize	Bir yeri benzersiz şekilde tanımlayan metin tabanlı tanımlayıcı. Yerle ilgili bilgi almak için bu tanımlayıcıyı Places API isteğinin `place_id` alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için yer kimliğine genel bakış bölümünü inceleyin.
`plus_code`	isteğe bağlı	`PlusCode`	Enlem ve boylam koordinatlarından türetilen, bir alanı temsil eden kodlanmış konum referansı: derecenin 1/8.000'i x derecenin 1/8.000'i (ekvatorda yaklaşık 14 m x 14 m) veya daha küçük. Plus Code'lar, açık adreslerin bulunmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerler) açık adreslerin yerine kullanılabilir. Açık Konum Kodu ve Plus Code'lar sayfalarına bakın. Daha fazla bilgi için `PlusCode` sayfasına göz atın.
`price_level`	isteğe bağlı	sayı	Yerin 0 ile 4 arasında bir ölçekte fiyat seviyesi. Belirli bir değerle gösterilen tam tutar bölgeden bölgeye değişir. Fiyat seviyeleri şu şekilde yorumlanır: 0 Ücretsiz 1 Pahalı değil 2 Orta 3 Pahalı 4 Çok pahalı
`rating`	isteğe bağlı	sayı	Toplu kullanıcı yorumlarına göre yerin 1, 0 ile 5, 0 arasındaki puanını içerir.
`reference`	isteğe bağlı	dize	`reference` desteği sonlandırıldı.
`reservable`	isteğe bağlı	boole	Yerin rezervasyonları destekleyip desteklemediğini belirtir.
`reviews`	isteğe bağlı	Dizi<PlaceReview>	En fazla beş yorum içeren bir JSON dizisi. Yorumlar varsayılan olarak alaka düzeyine göre sıralanır. Sıralamayı kontrol etmek için `reviews_sort` istek parametresini kullanın. `most_relevant` (varsayılan) için yorumlar alaka düzeyine göre sıralanır. Hizmet, sonuçları tercih edilen dilde yazılmış yorumları döndürecek şekilde önceliklendirir. `newest` için yorumlar kronolojik sıraya göre sıralanır. Tercih edilen dil, sıralama ölçütünü etkilemez. Google, sonuçların `most_relevant` veya `newest` ölçütüne göre sıralanıp sıralanmadığını kullanıcılara belirtmenizi önerir. Daha fazla bilgi için PlaceReview sayfasına bakın.
`scope`	isteğe bağlı	dize	`scope` desteği sonlandırıldı.
`secondary_opening_hours`	isteğe bağlı	Dizi<PlaceOpeningHours>	Bir işletmenin ikincil çalışma saatleri hakkındaki bilgiler de dahil olmak üzere sonraki yedi gün için bir giriş dizisi içerir. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran, arabaya servis saatlerini veya teslimat saatlerini ikincil çalışma saatleri olarak belirtebilir. Bu alan, yerin türlerine göre önceden tanımlanmış çalışma saatleri türleri listesinden (ör. `DRIVE_THROUGH`, `PICKUP` veya `TAKEOUT`) alınan `type` alt alanını doldurur. Bu alan, istisnai çalışma saatleri olan tarihler için ayarlanan tüm saatlerin `special_days` alt alanını içerir. Daha fazla bilgi için PlaceOpeningHours sayfasına bakın.
`serves_beer`	isteğe bağlı	boole	Mekanda bira servisi yapılıp yapılmadığını belirtir.
`serves_breakfast`	isteğe bağlı	boole	Yerin kahvaltı servisi yapıp yapmadığını belirtir.
`serves_brunch`	isteğe bağlı	boole	Mekanda geç kahvaltı servisi olup olmadığını belirtir.
`serves_dinner`	isteğe bağlı	boole	Yerin akşam yemeği servisi yapıp yapmadığını belirtir.
`serves_lunch`	isteğe bağlı	boole	Mekanda öğle yemeği servisi yapılıp yapılmadığını belirtir.
`serves_vegetarian_food`	isteğe bağlı	boole	Yerde vejetaryen yemek servis edilip edilmediğini belirtir.
`serves_wine`	isteğe bağlı	boole	Yerde şarap servisi yapılıp yapılmadığını belirtir.
`takeout`	isteğe bağlı	boole	İşletmenin paket servis hizmeti sunup sunmadığını belirtir.
`types`	isteğe bağlı	Dizi<string>	Belirli bir sonucu açıklayan özellik türlerinin dizisini içerir. Desteklenen türlerin listesine bakın.
`url`	isteğe bağlı	dize	Bu yerin resmi Google sayfasının URL'sini içerir. Bu, yerle ilgili mevcut en iyi bilgileri içeren Google'a ait sayfa olacaktır. Uygulamalar, kullanıcıya yerle ilgili ayrıntılı sonuçlar gösteren tüm ekranlarda bu sayfaya bağlantı vermeli veya bu sayfayı yerleştirmelidir.
`user_ratings_total`	isteğe bağlı	sayı	Bu yerle ilgili metin içeren veya içermeyen yorumların toplam sayısı.
`utc_offset`	isteğe bağlı	sayı	Bu yerin geçerli saat diliminin UTC'den kaç dakika farklı olduğunu içerir. Örneğin, yaz saati uygulaması sırasında Avustralya'nın Sidney şehrindeki yerler için bu değer 660 (UTC'den +11 saat) ve yaz saati uygulaması dışında Kaliforniya'daki yerler için -480 (UTC'den -8 saat) olur.
`vicinity`	isteğe bağlı	dize	Yalnızca işletme (`types:["establishment", ...])`) sonuçları için `vicinity` alanı, yerin basitleştirilmiş bir adresini içerir. Bu adreste sokak adı, sokak numarası ve semt bilgileri yer alır ancak il/eyalet, posta kodu veya ülke bilgileri bulunmaz. Diğer tüm sonuçlar için `vicinity` alanı, sonucun adresinde bulunan en dar siyasi (`types:["political", ...]`) özelliğin adını içerir. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.
`website`	isteğe bağlı	dize	Bu yerin yetkili web sitesi (ör. bir işletmenin ana sayfası).
`wheelchair_accessible_entrance`	isteğe bağlı	boole	Yerin tekerlekli sandalye kullanıcılarına uygun bir girişi olup olmadığını belirtir.

PlaceEditorialSummary

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve varsa bunların dil kodunu da içerir. Özet metni olduğu gibi sunulmalıdır, değiştirilemez veya üzerinde oynama yapılamaz.

Alan	Zorunlu	Tür	Açıklama
`language`	isteğe bağlı	dize	Önceki alanların dili. Her zaman mevcut olmayabilir.
`overview`	isteğe bağlı	dize	Yerin orta uzunlukta metin özeti.

PlaceOpeningHours

Bir yerin çalışma saatlerini açıklayan nesne.

Alan	Zorunlu	Tür	Açıklama
`open_now`	isteğe bağlı	boole	Yerin şu anda açık olup olmadığını gösteren bir boole değeri.
`periods`	isteğe bağlı	Array<PlaceOpeningHoursPeriod>	Pazar gününden başlayarak kronolojik sırayla yedi günü kapsayan çalışma saatleri dizisi. Daha fazla bilgi için PlaceOpeningHoursPeriod sayfasına bakın.
`special_days`	isteğe bağlı	Dizi<PlaceSpecialDay>	Önümüzdeki yedi güne karşılık gelen en fazla yedi girişten oluşan bir dizi. Daha fazla bilgi için PlaceSpecialDay sayfasına bakın.
`type`	isteğe bağlı	dize	İkincil çalışma saatlerinin türünü tanımlamak için kullanılan bir tür dizesi (ör. `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`). Yalnızca `secondary_opening_hours` için ayarlanır.
`weekday_text`	isteğe bağlı	Dizi<string>	Yerin çalışma saatlerini kullanıcıların okuyabileceği metinlerle açıklayan bir dize dizisi.

PlaceOpeningHoursPeriod

Alan	Zorunlu	Tür	Açıklama
`open`	required	PlaceOpeningHoursPeriodDetail	Yerin ne zaman açıldığını açıklayan bir çift gün ve saat nesnesi içerir. Daha fazla bilgi için PlaceOpeningHoursPeriodDetail sayfasını inceleyin.
`close`	isteğe bağlı	PlaceOpeningHoursPeriodDetail	Yerin ne zaman kapandığını açıklayan bir çift gün ve saat nesnesi içerebilir. Bir yer her zaman açıksa yanıtta kapanış bölümü yer almaz. İstemciler, her zaman açık olan işletmelerin, gün değeri `0` ve saat değeri `0000` olan ve `close` içermeyen açık bir dönem olarak gösterileceğinden emin olabilir. Daha fazla bilgi için PlaceOpeningHoursPeriodDetail sayfasını inceleyin.

PlaceSpecialDay

Alan	Zorunlu	Tür	Açıklama
`date`	isteğe bağlı	dize	Yerin yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).
`exceptional_hours`	isteğe bağlı	boole	Bu gün için istisnai çalışma saatleri varsa True değerini döndürür. `true` ise bu gün için en az bir istisna olduğu anlamına gelir. İstisnalar, `current_opening_hours` ve `secondary_opening_hours` alt alanlarında `periods`, `weekday_text`, `open_now` gibi farklı değerlerin oluşmasına neden olur. İstisnalar saatler için geçerlidir ve saatler diğer alanları oluşturmak için kullanılır.

PlaceOpeningHoursPeriodDetail

Alan	Zorunlu	Tür	Açıklama
`day`	required	sayı	Pazar gününden başlayarak haftanın günlerine karşılık gelen 0-6 arasında bir sayı. Örneğin, 2 değeri Salı anlamına gelir.
`time`	required	dize	24 saatlik ssdd biçiminde bir saat içerebilir. Değerler 0000-2359 aralığındadır. Saat, yerin saat diliminde bildirilir.
`date`	isteğe bağlı	dize	Yerin yerel saat diliminde RFC3339 biçiminde ifade edilen bir tarih (ör. 2010-12-31).
`truncated`	isteğe bağlı	boole	Dönem, isteğin gönderildiği tarihte gece yarısından önce başlıyorsa ve/veya son gün gece yarısında ya da gece yarısından sonra sona eriyorsa ve yedi günlük kesinti nedeniyle kısaltılmışsa doğru değerini döndürür. Bu özellik, açılış veya kapanış döneminin bu yedi günlük sınırın ötesine uzayabileceğini gösterir.

PlacePhoto

Bir yerin fotoğrafı. Fotoğrafa, aşağıdaki kalıpta bir URL kullanarak Place Photo API ile erişilebilir:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Daha fazla bilgi için Place Photos sayfasını inceleyin.

Alan	Zorunlu	Tür	Açıklama
`height`	required	sayı	Fotoğrafın yüksekliği.
`html_attributions`	required	Dizi<string>	Fotoğrafın HTML atıfları.
`photo_reference`	required	dize	Fotoğraf isteği gönderdiğinizde fotoğrafı tanımlamak için kullanılan dize.
`width`	required	sayı	Fotoğrafın genişliği.

PlaceReview

Bir kullanıcı tarafından gönderilen yer yorumu.

Alan	Zorunlu	Tür	Açıklama
`author_name`	required	dize	Yorumu gönderen kullanıcının adı. Anonim yorumlar "Bir Google kullanıcısı"na atfedilir.
`rating`	required	sayı	Kullanıcının bu yer için verdiği genel puan. Bu, 1 ile 5 arasında bir tam sayıdır.
`relative_time_description`	required	dize	Yorumun gönderildiği zamanın, geçerli zamana göre metin olarak ifadesi.
`time`	required	sayı	Yorumun gönderildiği zaman. 1 Ocak 1970 gece yarısından (UTC) itibaren geçen saniye sayısı olarak ölçülür.
`author_url`	isteğe bağlı	dize	Kullanıcının Google Haritalar Yerel Rehberler profilinin URL'si (varsa).
`language`	isteğe bağlı	dize	Döndürülen yorumun dilini belirten bir IETF dil kodu.Bu alan yalnızca ana dil etiketini içerir, ülke veya bölgeyi belirten ikincil etiketi içermez. Örneğin, tüm İngilizce yorumlar "en-AU" veya "en-UK" olarak değil, "en" olarak etiketlenir.Yorum metni olmadan yalnızca puan varsa bu alan boş bırakılır.
`original_language`	isteğe bağlı	dize	Yorumun orijinal dilini belirten bir IETF dil kodu. Yorum çevrilmişse `original_language` != `language`.Bu alan yalnızca ana dil etiketini içerir, ülke veya bölgeyi belirten ikincil etiketi içermez. Örneğin, tüm İngilizce yorumlar "en-AU" veya "en-UK" vb. olarak değil, "en" olarak etiketlenir. Yorum metni olmadan yalnızca puan varsa bu alan boş bırakılır.
`profile_photo_url`	isteğe bağlı	dize	Varsa kullanıcının profil fotoğrafının URL'si.
`text`	isteğe bağlı	dize	Kullanıcının yorumu. Google Places ile bir konumu incelerken metin yorumları isteğe bağlı olarak kabul edilir. Bu nedenle, bu alan boş olabilir. Bu alanın temel HTML işaretlemesi içerebileceğini unutmayın. Örneğin, `&` varlık referansı, ve işaretini temsil edebilir.
`translated`	isteğe bağlı	boole	Yorumun yazıldığı orijinal dilden çevrilip çevrilmediğini gösteren boole değeri.Bir yorum çevrilmişse (true değerine karşılık gelir) Google, bunu kullanıcılarınıza belirtmenizi önerir. Örneğin, yoruma "Google tarafından çevrildi" dizesini ekleyebilirsiniz.

Yer Ayrıntıları (eski) Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yer Ayrıntıları (Eski) istekleri

Gerekli parametreler

place_id

İsteğe bağlı parametreler

Fields

language

bölge

reviews_no_translations

reviews_sort

sessiontoken

Yer Ayrıntıları (Eski) örneği

kabuk

HTTP

Yer Ayrıntıları (Eski) yanıtı

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

Yer

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

Yer Ayrıntıları (eski)

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`